Re: Indexing p6 documentation

2000-08-31 Thread Tim Conrow
Michael G Schwern wrote: > > On Tue, Aug 01, 2000 at 08:26:22PM -0700, Tim Conrow wrote: > > My problem with X<> it is that it's disruptive to the readability of > > the text if it's embedded and used too much, as it might well be for > > indexing. I was trying to navigate a way around that probl

Re: Indexing p6 documentation

2000-08-30 Thread Michael G Schwern
On Tue, Aug 01, 2000 at 08:26:22PM -0700, Tim Conrow wrote: > My problem with X<> it is that it's disruptive to the readability of > the text if it's embedded and used too much, as it might well be for > indexing. I was trying to navigate a way around that problem. I've been using X<> while writi

Re: Indexing p6 documentation

2000-08-04 Thread Russ Allbery
Tim Conrow <[EMAIL PROTECTED]> writes: > My problem with X<> it is that it's disruptive to the readability of the > text if it's embedded and used too much, as it might well be for > indexing. I was trying to navigate a way around that problem. I confess > I haven't worked out how to deal with fi

Re: Indexing p6 documentation

2000-08-01 Thread Jonathan Scott Duff
On Tue, Aug 01, 2000 at 06:13:23PM -0700, Tim Conrow wrote: > Perl5's otherwise excellent documentation lacks a "conceptual index". Good idea. Submit an RFC. The format and sample RFC can be found at http://prometheus.frii.com/~gnat/p6/ :-) -Scott -- Jonathan Scott Duff [EMAIL PROTECTED]

Re: Indexing p6 documentation

2000-08-01 Thread Tim Conrow
"Bryan C. Warnock" wrote: > > On Tue, 01 Aug 2000, Tim Conrow wrote: > > Authors would have to provide explicit indexing hints. E.g. > > > > = begin index_hints > > > > loop,"control structures",for,while,block,{,},last,redo,continue,label > > > > = end index_hints > > > > One set of hints per do

Re: Indexing p6 documentation

2000-08-01 Thread Bryan C . Warnock
On Tue, 01 Aug 2000, Matthew Persico wrote: > Seems to me that any entry that could make it to an index is probably a > good candidate for a hyperlink. Doesn't L<> already fit the bill here > for what you want? Well, I didn't really suggest, so I don't know what I want. ;-) But in response to

Re: Indexing p6 documentation

2000-08-01 Thread Matthew Persico
"Bryan C. Warnock" wrote: > > On Tue, 01 Aug 2000, Tim Conrow wrote: > > Perl5's otherwise excellent documentation lacks a "conceptual index". > > This would include those characters, words or expressions to which doc > > authors want pointers. Authors would have to provide explicit indexing > >

Re: Indexing p6 documentation

2000-08-01 Thread Bryan C . Warnock
On Tue, 01 Aug 2000, Tim Conrow wrote: > Perl5's otherwise excellent documentation lacks a "conceptual index". > This would include those characters, words or expressions to which doc > authors want pointers. Authors would have to provide explicit indexing > hints. E.g. > > = begin index_hints >