On 2014-08-28 12:44-0400 Hazen Babcock wrote:

> On 8/28/2014 11:24 AM, Alan W. Irwin wrote:
>> My README and website changes have been pushed as of d5b1568, and the
>> corresponding changes to the website have been uploaded.  Please take
>> a critical look at README and http://plplot.sourceforge.net and
>> http://plplot.sourceforge.net/downloads.php (where most of the website
>> changes occurred) in case you spot any additional changes that should
>> be done.
>
> Overall it looks good to me.

Thanks for that review.

> In the README file, should I be able to click on the links when viewed here?
> http://sourceforge.net/p/plplot/plplot/ci/master/tree/

I don't think that is possible with plain text (which we want this
file to be for the case when this README file is included, say, in a
tarball).  According to
<http://sourceforge.net/p/forge/documentation/Files-Readme/> raw html
is simply escaped for plain text files.  Of course, the
angle-bracketed style I am using in this README for URL's is not html,
but the implication of the SF documentation or readme files is there
is not much you can do to make links clickable for plain text files.

I also looked at
http://sourceforge.net/p/plplot/plplot/ci/master/tree/doc/docbook/
There the URL's in the README file in that directory are not
angle-bracketed, but those links are still not clickable indicating
my angle brackets in the README file in the top-level directory
are not interfering with clickability.

Until I looked at that last case (where that directory also includes a
file called README.developers which was updated more recently
than README in that directory) I was concerned about an implication in
the above SF documentation that the latest updated README.* file would
be the one displayed. Clearly, from the doc/docbook/README case that
rule does not apply to files called exactly "README" so the next time
we update one of README.developers, README.release, or
README.Release_managers_cookbook in the top-level directory, the
README file in that directory should still be displayed at
<http://sourceforge.net/p/plplot/plplot/ci/master/tree/> (which is the
result we want).

Alan
__________________________
Alan W. Irwin

Astronomical research affiliation with Department of Physics and Astronomy,
University of Victoria (astrowww.phys.uvic.ca).

Programming affiliations with the FreeEOS equation-of-state
implementation for stellar interiors (freeeos.sf.net); the Time
Ephemerides project (timeephem.sf.net); PLplot scientific plotting
software package (plplot.sf.net); the libLASi project
(unifont.org/lasi); the Loads of Linux Links project (loll.sf.net);
and the Linux Brochure Project (lbproject.sf.net).
__________________________

Linux-powered Science
__________________________

------------------------------------------------------------------------------
Slashdot TV.  
Video for Nerds.  Stuff that matters.
http://tv.slashdot.org/
_______________________________________________
Plplot-devel mailing list
Plplot-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/plplot-devel

Reply via email to