"=language foo" (was Re: Pod::Simple)

2003-07-01 Thread Sean M. Burke
At 03:27 PM 2003-07-01 +0300, Jarkko Hietaniemi wrote: > >(2) I haven't actually seen Autrijus =encoding proposal :-) ... but how > >about the possibility of indicating the languages, too? =language > >ISO639codehere. > Just for the sake of metadata, you mean? What uses do you have in mind for

Re: "=head1 Blorblor (FOO)" (was Re: Pod::Simple)

2003-07-01 Thread Jarkko Hietaniemi
> Okay, that makes sense. Nice and straightforward. > So then the new logic for the "What's the title method" would just need to > tolerate "=head1 blah blah blah whatever (NAME)" as a variant of "=head1 > NAME", i.e., both meaning "the next paragraph will be the short title of > this document"

"=head1 Blorblor (FOO)" (was Re: Pod::Simple)

2003-07-01 Thread Sean M. Burke
At 03:27 PM 2003-07-01 +0300, Jarkko Hietaniemi wrote: =head1 DESCRIPTION ... =head1 Qwertyuiop (DESCRIPTION) ... And then someone wanting create an index where both DESCRIPTION and Qwertyuiop are recognized as "descriptions". All this makes sense of course only for applications that have define

Re: Pod::Simple

2003-07-01 Thread Jarkko Hietaniemi
> >How about (just to throw out an idea) this syntax? > >=head1 NAME Etaoinshrdlu > >or > >=head1 Etaoinshrdlu NAME > >Or maybe > >=head1 Etaoinshrdlu (NAME) > > Do you mean "Etaoinshrdlu" here to stand for the name of the module, or the > word for "Name" in whatever language? The latter. > >Wh

Re: Pod::Simple

2003-07-01 Thread Sean M. Burke
At 10:30 AM 2003-07-01 +0300, Jarkko Hietaniemi wrote: How about (just to throw out an idea) this syntax? =head1 NAME Etaoinshrdlu or =head1 Etaoinshrdlu NAME Or maybe =head1 Etaoinshrdlu (NAME) Do you mean "Etaoinshrdlu" here to stand for the name of the module, or the word for "Name" in whatever

Re: Pod::Simple

2003-07-01 Thread Jarkko Hietaniemi
Hmmm. (1) What if someone wants to index multilingual pods, in all the languages? How about (just to throw out an idea) this syntax? =head1 NAME Etaoinshrdlu or =head1 Etaoinshrdlu NAME In other words, if there is the literal 'NAME' either as the first or the last 'word', it is a 'NAME' secti

Re: Pod::Simple

2003-07-01 Thread Jarkko Hietaniemi
On Mon, Jun 30, 2003 at 11:09:03PM -0800, Sean M. Burke wrote: > At 09:09 AM 2003-07-01 +0300, Jarkko Hietaniemi wrote: > >> - Otherwise, use the file's basename as the title. > >So the model is exactly one encoding+language per one pod file? > > Hm. Well, I assume one title per pod-file. > And I

Re: Pod::Simple

2003-07-01 Thread Sean M. Burke
At 09:09 AM 2003-07-01 +0300, Jarkko Hietaniemi wrote: > - Otherwise, use the file's basename as the title. So the model is exactly one encoding+language per one pod file? Hm. Well, I assume one title per pod-file. And I am /hoping/ for exactly one encoding per file, unless someone has any object

Re: Pod::Simple

2003-07-01 Thread Jarkko Hietaniemi
> - If the first Pod thing is a =head1 NAME, and the next paragraph is short > and might even look like "thing -- thing thing thing thing thing", then get > the name/description from that. > > - Otherwise if the first pod thing is a =head1 X where "X" is some > string that doesn't conta