Re: perlpodspec, draft 2

2001-10-03 Thread Jarkko Hietaniemi
I think it'll take a lot more thought (and me sitting in diners and scribbling lots of code on the back of napkins), and I don't want to prematurely add it to current perlpodspec until I'm sure of how it needs to happen. For the moment, I want the current perlpodspec (once I tidy up a few

Re: perlpodspec, draft 2

2001-10-02 Thread Nick Ing-Simmons
Russ Allbery [EMAIL PROTECTED] writes: Jarkko Hietaniemi [EMAIL PROTECTED] writes: In other words, LPod::Parser is likely to be rendered simply as Pod::Parser, but I don't know what to do with Lperlfunc/die or LTheory of MIMEs. Just strip the L and leave the contents of the link as-is? Do

Re: perlpodspec, draft 2

2001-10-01 Thread Sean M. Burke
perlpodspec draft 2 describe the rendering with a must (whereas I think I previously had a should, and vacillated on Lfoo/bar links): In case of LElt... codes with no text| part in them, older formatters have exhibited great variation in actually displaying the link or cross reference

Re: perlpodspec, draft 2

2001-10-01 Thread Russ Allbery
Sean M Burke [EMAIL PROTECTED] writes: In other words, LPod::Parser is likely to be rendered simply as Pod::Parser, but I don't know what to do with Lperlfunc/die or LTheory of MIMEs. As if they were: Ldie in perlfunc|perlfunc/die LTheory of MIMEs|Theory of MIMEs You've sold me.

Re: perlpodspec, draft 2

2001-10-01 Thread Kurt D. Starsinic
On Oct 01, Jarkko wrote: In case of LElt... codes with no text| part in them, older formatters have exhibited great variation in actually displaying the link or cross reference. For example, LEltcrontab(5) would render as the Ccrontab(5) manpage, or in the Ccrontab(5) manpage or just

Re: perlpodspec, draft 2

2001-10-01 Thread Jarkko Hietaniemi
Getting rid of the the ... manpage thing is on my list of changes to make in the next version of pod2man and pod2text. I'm not sure what to do about things like section and entry though. Suggestions? In other words, LPod::Parser is likely to be rendered simply as Pod::Parser, but I don't

Re: perlpodspec, draft 2

2001-10-01 Thread Russ Allbery
Jarkko Hietaniemi [EMAIL PROTECTED] writes: In other words, LPod::Parser is likely to be rendered simply as Pod::Parser, but I don't know what to do with Lperlfunc/die or LTheory of MIMEs. Just strip the L and leave the contents of the link as-is? Do you think that will make sense enough

Re: perlpodspec, draft 2

2001-10-01 Thread Russ Allbery
Jarkko Hietaniemi [EMAIL PROTECTED] writes: In case of LElt... codes with no text| part in them, older formatters have exhibited great variation in actually displaying the link or cross reference. For example, LEltcrontab(5) would render as the Ccrontab(5) manpage, or in the Ccrontab(5)

Re: perlpodspec, draft 2

2001-09-25 Thread Philip Newton
On Sun, 23 Sep 2001 23:05:27 -0600, in perl.perl5.porters you wrote: [endquote] I think that those paragraphs should just be removed; paragraph-based parsing seems to have been largely abandoned, because of the hassle with non-empty blank lines messing up what people meant by paragraph.

perlpod/perlpodspec draft 2 forthcoming

2001-09-04 Thread Sean M. Burke
FYI: I've been spending the past week thinking a great deal about the issue of encodings for POD. That's the one issue I've really been stuck on -- lots of ways to do it, each with its own problems and advantages. But I think I've reasoned it out to my satisfaction now. Now that that's