Get started with CVS (behind a firewall too)

• First you need the CVS Client, you can download it for free from http://www.cvshome.org/ (direct download http://ftp.cvshome.org/win32/cvs-1-11-1p1.zip). Place the cvs.exe file somewhere in your system's PATH.
• To download all files the first time you must do a so called "check out":
  1. Login to the server, enter in the DOS Prompt:
     cvs -d:pserver:anonymous@syn.cvs.sourceforge.net:/cvsroot/syn login
     If you're prompted for a Password just press Enter.
  2. To do the check out of v2.1 branch, enter:
     cvs -d:pserver:anonymous@syn.cvs.sourceforge.net:/cvsroot/syn checkout -r syn_2_1_0_branch syn
     
  3. To do the check out of latest syn version, enter:
     cvs -d:pserver:anonymous@syn.cvs.sourceforge.net:/cvsroot/syn checkout syn
     Note: Module name is here syn, this means it will download all files in the directory "syn" and its subdirectories (unless you add the l switch).
• To update to newer sources:
  1. Go to the root directory from Syn (e.g. D:\MyFiles\syn)
  2. enter in the DOS Prompt:
     cvs -d:pserver:anonymous@syn.cvs.sourceforge.net:/cvsroot/syn update -dP syn
• If you set the environment variable "CVSROOT" to
  :pserver:anonymous@syn.cvs.sourceforge.net:/cvsroot/syn
  you can omit
  -d:pserver:anonymous@syn.cvs.sourceforge.net:/cvsroot/syn
  from the commandline.
• The switches:
  • The d switch is for creating directories which exists on the Server but not locally.
  • The P switch deletes empty directories.
  • If you add the l switch it updates only the local directory, i.e. it does no recursion.
  • If you add the C option you'll get a clean copy (no merging), your changes are overwritten.
    Example: cvs update -dPC.
• If you want to enable TCP/IP compression for a faster download, add the z switch, you can choose a value between 1 and 9.
  Example: cvs -z3 update -dP. Using a high compression rate will cause more CPU usage on the client as well as on the server.
• If you get an error message like "File D:\users\default\.cvspass not found" or something like this, then create an empty file with this name. This is a bug in the Windows port from the cvs.exe.
• Note: This options are case sensitive.
• It is probably easier to use a Frontend to CVS such as Jordan Russel's InnoCVS (very easy to use), WinCVS, or TortoiseCVS. The CVS Client (cvs.exe) is included in the WinCVS and TortoiseCVS distribution.
• For more informations see http://sourceforge.net/cvs/?group_id=58130.



• You can use CVS even behind a firewall (at least I can). You have to use CVSNT client (I use version 2.0.11.0, included in latest TortoiseCVS), or any other that support setting proxy and proxyport in CVSROOT :
  :pserver;proxy=YOUR_PROXY;proxyport=YOUR_PROXY_PORT:anonymous@syn.cvs-pserver.sf.net:443:/cvsroot/syn
  Use this value in any of examples above and they will work even behind a firewall. Note that it not only specifies your proxy server, but SourceForge CVS server (after "anonymous@") is different too. Read SourceForge docs for more information.
  
• Instructions above will work, if your proxy supports CONNECT command. If that is not your case, you can use CVS Grab tool to get latest sources from CVS.

---

How to translate Syn

• Read this first

  Before starting some translation, it is important to write to syn-devel maillist to see if someone else is started translation to your language. Translation is not a very short process, so it is always better when it is done by common efforts.

• Translation of the user interface

  Version 3.0 will allow translation of Syn user interface. If you want to make one to your native language, you can download preview of syn 3.0, install it and and follow instructions in ReadMe.txt, located in Language subfolder.

• Translation of Syn manual

  You can download source of the manual from here. We are trying to keep manual source synchronized, but just for sure it is good idea to see what has changed in the CVS from the last version before translation. If you find texts, that are outdated, contact us and translate first some of the others, that are not affected from the changes.

• Translation of Syn homepage

  Source of Syn homepage is available here (25 KB). You will find in the archive a file that explains what to do, to help you in the translation process.

• Credits

  We will give appropriate credits to the translators - their name and e-mail and/or Website (if they want) will be placed respectively in the About box, on the first page of the manual and in the team members list in the homepage. And, of course, their name will be added in contributors list.

---

Links

To compile Syn, you will need some components:

• SynEdit ( http://synedit.sourceforge.net/ ), always get the latest CVS Version
• Toolbar2000, from Jordan Russell ( http://www.jrsoftware.org/ )
• Indy 9 (Internet Direct) ( http://www.nevrona.com/indy/ )
• Jedi Code Library (JCL) ( http://www.sourceforge.net/projects/jcl/ )

Refer to Readme.txt in the Syn sources archive file, for conditions of installation and use, and to get the complete list of components needed.

To compile Syn manual, you will need:

• MiKTeX ( http://www.miktex.org/ )
• TeXnicCenter ( http://www.toolscenter.org/products/texniccenter/ )

---