Re: Email addresses for package authors and maintainers

[Carnë Draug]

On 1 September 2014 17:42, Julien Bect <address@hidden> wrote:
> Hello all,
>
> For most (all ?) Octave-Forge packages, the "package_box_contents" container
> looks like this:
>
> ---------------------------------------------
> <div class="package_box_contents">
> <table>
> <tr><td class="package_table">Package Version:</td><td>1.2.0</td></tr>
> <tr><td class="package_table">Last Release
> Date:</td><td>2013-11-25</td></tr>
> <tr><td class="package_table">Package Author:</td><td>various
> authors</td></tr>
> <tr><td class="package_table">Package Maintainer:</td><td>Mike Miller
> <address@hidden></td></tr>
> <tr><td class="package_table">License:</td><td><a href="COPYING.html
> <view-source:http://octave.sourceforge.net/communications/COPYING.html>">GPLv3+</a></td></tr>
> </table>
> </div>
> ---------------------------------------------
>
> As you can see, the email address is included in the source but not
> displayed, because <...> is interpreted as an (incorrect) HTML tag.
>
> There are several ways for fixing this:
>
> a) Replace <...> by &lt;...&gt; to display the email address.
>
> b) Remove the email address from "package_box_contents".
>
> c) If there are mixed opinions about this, the generate_html package could
> also include an option for displaying the email addresses.

I'd go with option (a) and have the generate_html package escape the <
and > correctly. The package should not be making those decisions, it
should simply create that page based on what the maintainer wrote on
the DESCRIPTION file. If the maintainer does not want an email there,
he can simply remove it from the package's DESCRIPTION file.

Carnë