Once you've verified that the new distribution looks good and you've checked in the XML release files, you are ready to build a snapshot of the documentation at the time of release. Since this build takes a long time to complete, it is recommended that one configure and build just the HTML document first and review its content. The following commands can be used to build a "release" version of the HTML documentation:

[root@quesadilla nst]# ./configure --config-dir include/dist --on-line-docs


   ... output from configuration ...


[root@quesadilla nst]# make -C html all IF_RELEASE_DOCS='@param(0)'


   ... output from HTML build ...


[root@quesadilla fc2]# firefox http://127.0.0.1/nst
[root@quesadilla fc2]# 

Once the above ouput looks reasonable, you can proceed to the final build (which takes a LONG time) by invoking:

[root@quesadilla nst]# make release-docs

This will take care of building the documentation for the release and storing a copy at the proper location at SourceForge. In addition, you will need to upload the file: "nst-docs-1.10.0.tar.gz" to SourceForge and add it to the release

As SourceForge does not like projects to use too much disk space on the web server, you will need to log into SourceForge and "trim off" old snapshots of the documentation. This can be done in the following manner:

[root@dhcp138 nst]# ssh -t SFUSERID,nst@shell.sourceforge.net create

Requesting a new shell for "SFUSERID" and waiting for it to start.
queued... starting...

This is an interactive shell created for user SFUSERID,nst.
Use the "timeleft" command to see how much time remains before shutdown.
Use the "shutdown" command to destroy the shell before the time limit.
For path information and login help, type "sf-help".

-bash-3.2$ cd /home/groups/n/ns/nst
-bash-3.2$ cd htdocs
-bash-3.2$ ls
1.4.2  1.5.0  1.8.0  nst
-bash-3.2$ rm -fr 1.4.2
-bash-3.2$ exit
logout
Connection to shell-24004 closed.
Connection to shell.sourceforge.net closed.
[root@dhcp138 nst]#