On 19 Oct 2009, at 10:28, Carlo de Falco wrote:
On 17 Oct 2009, at 23:58, Søren Hauberg wrote:
Hi All
<...>
For a long time essential parts of this code has been incomplete, but
I've recently been taking a stab at this once more. You can check out
the results at
http://octave.sf.net/test
<..>
Søren
Søren,
Sorry I didn't have time to contibute more,
but it seems you have managed to do a really great job!
I really love this!
Now, what would be really needed to start thorough testing would be
a description of the precise steps that a package maintainer would
need to do to publish a new version of his/her package. Before you
move the new design to the production website I'd like as many as
possible of the package maintainers to try to update their packages
and to hear thei impressions on the procedure required for doing that.
If you want I can prepare a short description to add on the OF
developers guide.
If I understand correctly the steps to follow would be:
1) bump the version number in the package DESCRIPTION file
2) produce a tar.gz of the package and add it to the sf release system
3) generate the function reference HTML files with
generate_package_html
4) delete the contents of the folder containing the package help on
the www sever
5) upload the new help files
Am I missing something?
c.
Søren,
After a loooooooong time I finally got a chance to try doing this,
the patch to add the upload procedure to the developers webpage is
attached.
I would have applied it myself but I did not have write permission on
that file.
Also, the description of the procedure is only theory as in practice I
could not
really run it because of some errors:
1) I do not have enough privileges to delete the contents of
/home/groups/o/oc/octave/htdocs/test/nurbs
2) generate_package_html does not seem to work properly on my system:
---------------------------------
>> pkg load generate_html
>> generate_package_html ('nurbs', 'nurbs-html', 'octave-forge')
warning: marking 'nrbkntmult' as not implemented
error: `get_alpha_database' undefined near line 200 column 41
error: called from:
error: /Users/carlo/octave/generate_html-0.0.9/
generate_package_html.m at line 200, column 39
---------------------------------
maybe you forgot to check-in some function?
Thanks again for the nice job,
Carlo
--- developers.html.orig 2009-11-15 10:57:02.000000000 +0100
+++ developers.html 2009-11-15 10:56:07.000000000 +0100
@@ -483,6 +483,83 @@
on the server (?), e.g., because you submitted a patch for someone else to
apply.</li>
</ul>
+<h3>Make a release of your package and publish its function reference</h3>
+<p>
+When you are ready to make a new release of your package you will have
+to update the website to show the package newly released as follows:
+<ul>
+ <li>
+ bump the `Version' number (and optionally the `SVNRelease') in the
+ package DESCRIPTION file
+ </li>
+
+ <li>
+ produce a tar.gz of the package
+ <pre>
+ $ cd
+ $ cd Desktop/OF/octave-forge/extra/
+ $ svn export nurbs ~/nurbs
+ Export complete.
+ $ cd
+ $ grep -i version nurbs/DESCRIPTION
+ Version: 1.0.2
+ License: GPL version 2 or later
+ $ tar czf nurbs-1.0.2.tar.gz nurbs/
+ $ ls *.tar.gz
+ nurbs-1.0.2.tar.gz
+ </pre>
+ </li>
+
+ <li>
+ upload the tarball to the sourceforge release system, following
+ instructions given <a
+
href="https://sourceforge.net/apps/trac/sourceforge/wiki/Release%20files%20for%20download";>here</a>,
+ for example:
+ <pre>
+ $ sftp cdf,[email protected]
+ Connecting to frs.sourceforge.net...
+ cdf,[email protected]'s password:
+ $ sftp> cd /home/frs/project/o/oc/octave/Octave\ Forge\
Packages/Individual\ Package\ Releases/
+ $ sftp> put nurbs-1.0.2.tar.gz
+ Uploading nurbs-1.0.2.tar.gz to /home/frs/project/o/oc/octave/Octave Forge
Packages/Individual Package Releases/nurbs-1.0.2.tar.gz
+ nurbs-1.0.2.tar.gz
100% 52KB 25.9KB/s
00:02
+ sftp> exit
+ </pre>
+ </li>
+
+ <li>
+ generate the function reference HTML files with
+ generate_package_html:
+ <pre>
+ $ octave -q --eval "pkg load generate_html; generate_package_html ('nurbs',
'nurbs-html', 'octave-forge')"
+ $ cd nurbs-html/
+ $ ls
+ nurbs short_package_descriptions
+ </pre>
+ </li>
+
+ <li>
+ delete the contents of the folder containing the package help on the
+ www sever:
+ <pre>
+ $ ssh -t cdf,[email protected] create
+ cd /home/groups/o/oc/octave/htdocs/test
+ [...@shell-21002 test]$ rm -rf nurbs/*
+ [...@shell-21002 test]$ exit
+ logout
+ </pre>
+ </li>
+
+ <li>
+ upload the new help files:
+ <pre>
+ $ scp -r ./nurbs-html/*
cdf,[email protected]:/home/groups/o/oc/octave/htdocs/test/nurbs
+ </pre>
+ </li>
+
+</ul>
+</p>
+
<h3>Learn more about SVN</h3>
<p>The few SVN commands shown here just scratch the surface of this
powerful versioning package. If you become an active contributor
------------------------------------------------------------------------------
Let Crystal Reports handle the reporting - Free Crystal Reports 2008 30-Day
trial. Simplify your report design, integration and deployment - and focus on
what you do best, core application coding. Discover what's new with
Crystal Reports now. http://p.sf.net/sfu/bobj-july
_______________________________________________
Octave-dev mailing list
[email protected]
https://lists.sourceforge.net/lists/listinfo/octave-dev
