Re: [Plplot-devel] README suggestion

[Alan W. I. <ir...@be...>]

On 2014-08-28 13:05-0700 David MacMahon wrote:

> Hi, Alan,
>
> On Aug 28, 2014, at 12:35 PM, Alan W. Irwin wrote:
>
>> According to
>> http://sourceforge.net/p/forge/documentation/Files-Readme/ it may be
>> that all I would have to do was change the README name to README.md to
>> make the SF software translate that file from markdown to html, but
>> then according to that same documention we would not be in a good
>> situation because any other file in the same directory with readme or
>> README somewhere in the name would take precedence if updated later
>> than README.md.
>
> Yeah, that multiple README resolution is potentially an issue.  Wouldn't that be an issue even for plain text README files?  Suppose someone changes README.emacs.  Would README.emacs be the README file that gets shown when browsing the repository?  Maybe they give priority to "README" (bare and with known extensions) over "*[Rr][Ee][Aa][Dd][Mm][Ee]*" to avoid this very problem?

I thought it would be an issue, but experimentally (and contrary to
the above documentation) it is not (at least for the git browse area
for SF).  The exact filename README always takes precedence over any
other variant of *README* for that browse area regardless of when
updated.  It's also possible that documentation is complete BS (say
left over from pre-Allura software days at SourceForge), but I don't
have time/inclination to do the various experiments to see what the
real story is so I am going to stick with the exact filename README
because I know that is the one that always receives precedence now
in the git browsing area.

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
__________________________