Re: [Savannah-hackers] docs

[Loic Dachary]

mathieu writes:
 > about his support request :
 > http://savannah.gnu.org/support/index.php?func=detailsupport&support_id=100446&group_id=11
 > 
 > 
 > I have written  a small doc in a text-file, attached with this message.
 > 
 > Tell my how you feel about it.

        Good :-) I suggest you insert it asap in the
http://savannah.gnu.org/docs/ directory. Even if not perfect, it will be
easier to contribute to it if on the CVS tree.

 > ***** Upload the project sources
 > 
 > 1) You should go in the local dir where you want to put your local CVS tree.
 > For example:
 > cd /opt
 > 
 > 2) You should follow instructions in your CVS project page on savannah.
 > - You need to configure your box to use SSH1. This could be basicaly done 
 > with:
 > echo "Protocol 1" > ~/.ssh/config
 > - You need to add a proper SSH Shared key in the Account Maintenance page. 
 > To generate a proper key, with a passphrase, do:
 > ssh-keygen

        Might be good to cut/past the exact same instructions that are found
in the CVS page and add a pointer to it.

 > - You must download the CVS tree structure:
 > export CVS_RSH=ssh 
 > cvs -z3 address@hidden:/cvsroot/myproject/ co myproject

"If all went well you should now have an empty directory called myproject"

 > 3) Then, in the dir /opt/myproject, you should copy anyfile you want to 
 > distribute.

   s/anyfile/all the files/
   s/distribute/insert in the CVS tree/

 > 4) Once you have localy set your project tree, you can upload it. To upload 
 > a file and a directory :

 > cd /opt/myproject
 > cvs add myfile
 > cvs add mydir
 > (or cvs add myfile mydir)
 > cvs commit
 > 
 > Read http://www.freenix.org/unix/linux/HOWTO-vo/CVS-RCS-HOWTO.html
 > Execute man cvs to get more informations.
 > 
 > ***** Upload the website
 > 
 > It works in the same way.
 > 
 > 1) You should go in the local dir where you want to put your local WWW CVS 
 > tree.
 > For example:
 > cd /opt/www
 > 
 > 2) You should follow instructions in your CVS project page on savannah.
 > - You need to configure your box to use SSH1. This could be basicaly done 
 > with:
 > echo "Protocol 1" > ~/.ssh/config
 > - You need to add a proper SSH Shared key in the Account Maintenance page. 
 > To generate a proper key, with a passphrase, do:
 > ssh-keygen
 > - You must download the CVS tree structure:
 > (for a non-gnu project)
 > export CVS_RSH=ssh
 > cvs -z3 address@hidden:/webcvs/ co non-gnu/myproject/
 > 
 > 3) Then, in the dir /opt/myproject, you should copy anyfile you want to put 
 > in your website
 > 
 > 4) Once you have localy set your project tree, you must upload it. To upload 
 > a file and a directory:
 > cd /opt/myproject
 > cvs add myfile
 > cvs add mydir
 > cvs commit
 > 
 > Read http://www.freenix.org/unix/linux/HOWTO-vo/CVS-RCS-HOWTO.html
 > Execute man cvs to get more informations.
 > 
 > 5) To use a symlinks, you must add a .symlinks file. For example, to make a 
 > ln -s src/pouf.css style.css do:
 > echo "src/pouf.css style.css" >> .symlinks

   Add a note that says : files committed show immediately, symlinks are
updated every 24 hours.

 > ****** Upload file in the download area for non-gnu projects
 > (http://freesoftware.fsf.org/download/myproject/)
 > 
 > You should use scp.
 > So you should have a registered ssh key (see previous sections)
 > - Go in the dir when files to upload are:
 > cd /opt/myproject/download
 > - Use scp:
 > scp myfile address@hidden:/upload/myproject

   Should add rsync related info too.

 > Execute man scp to get more informations.