Re: CG Information on Snippet Handling

[Carl D. Sorensen]

On 4/18/09 9:55 PM, "Graham Percival" <address@hidden> wrote:

> On Sat, Apr 18, 2009 at 09:16:47PM -0600, Carl D. Sorensen wrote:
>> 
>>> I don't mind what you do, so long as it doesn't break compilation. :)
>> 
>> OK, so how about this for proposal 3 for something to go into the CG:
> 
> Here's my proposal: since this will change in 6 weeks and it isn't
> urgent, we leave the CG alone.  Or simply put a "FIXME: will doc
> soon.  Ask for help if you need to do this" there.

I'll leave it alone.

But, remember, this got started because I asked how something was done, and
the answer was "Read the Fine CG".  The information I've proposed to add is
the answer to my question that wasn't in the CG.
egin
> 
>> surrounded by @address@hidden and @address@hidden ignore}.
> 
> BTW carl, you want @@ignore and @@end ignore.
> 

Thanks -- I would have figured it out when I actually got around to building
the docs.

>> To have a snippet appear in the documentation before the LSR update and/or
>> makelsr.py run have been completed,
> 
> ... go drink some vodka and play some online tower defense flash
> games, because that will be a more efficient use of your time.
> :)
> 

I have to "make web" anyway to see that docs still compile.  It takes maybe
30 seconds to copy a file to input/lsr and add % begin verbatim to it.  I
can't speak for anybody else, but for me personally, it's much better use of
my time to get the snippet in the docs before I do make web so I can make
sure it works right.

> (I was recovering from a big deadline yesterday.  Minus the vodka,
> I spent the day very efficiently.)
> 

Aren't deadlines fun!  Glad you had an efficient day.

Thanks,

Carl