S02 questions and comments

I'm reading S02.pod with version information:
Last Modified: 17 Mar 2008
Number: 2
Version: 130

Meta-question 1: what is the succinct way to report this?  Is the "Version 1
30" enough?

Meta-question 2: Does this belong on a different mailing list?  I'm also inc
luding the documented file maintainer as a direct recipient.

3: I copied the file from <http://svn.perl.org/perl6/doc/trunk/design/syn/> 
which I'm told is the up-to-date home.  When I ran pod2html, I got a warning
 that 'encoding' is an unknown directive, and also see that the HTML title i
s simply "TITLE".  Do I nee
d a special version of pod2html, or how do I run it properly?

4: "Whitespace is not allowed between a variable name and its subscript. How
ever, there is a corresponding dot form of each subscript"
The use of "however" looks like it is meant to imply that the dot form allow
s you to add space.  I think this wording is leftover from the "long dot" ex
planation, but now is out of place.  I suggest dropping the "However," from 
the sentence.

I'm also wondering, in general, why we still have the dot forms of the subsc
ripting (and other postfix operators) when the long-dot has been replaced by
 the unspace concept.

--John

On 30 Mar 2008 16:35:56 -0000, John M. Dlugosz <dhcgnd702@sneakemail.com> wrote:
> I'm reading S02.pod with version information:
>   Last Modified: 17 Mar 2008
>   Number: 2
>   Version: 130
>
>  Meta-question 1: what is the succinct way to report this?  Is the "Version 130" e
nough?

The SVN revision number is sufficient. By default we're just
pretending that we're referring to "the svn head".

>  3: I copied the file from <http://svn.perl.org/perl6/doc/trunk/design/syn/> which
 I'm told is the up-to-date home.  When I ran pod2html, I got a warning that 'encodi
ng' is an unknown directive, and also see that the HTML title is simply "TITLE".  Do
 I
need a special version of pod2html, or how do I run it properly?
>

IMHO pod2html is old and broken in various ways. I think you should
use the tools provided by Pod::Simple instead. For the Synopses on
feather, we're using the podhtml.pl script (based on
Pod::Simple::HTML):

http://svn.pugscode.org/pugs/util/podhtm.pl

Hopefully you may find it useful :)

Cheers,
-agentzh

On Sun, Mar 30, 2008 at 04:35:56PM -0000, John M. Dlugosz wrote:
: Meta-question 2: Does this belong on a different mailing list?  I'm also i
ncluding the documented file maintainer as a direct recipient.

This is the right list.  There is no need to cc the maintainers,
since they all read this list (or if they do not, are not really the
maintainers any more...)

: 4: "Whitespace is not allowed between a variable name and its subscript. H
owever, there is a corresponding dot form of each subscript"
: The use of "however" looks like it is meant to imply that the dot form all
ows you to add space.  I think this wording is leftover from the "long dot" 
explanation, but now is out of place.  I suggest dropping the "However," fro
m the sentence.

Fixed by unpacking what I really meant by the "however".  :)

Larry