Re: Simple documents and DocBook output

[Noah Slater]

On Wed, Dec 24, 2008 at 05:03:39PM -0600, Karl Berry wrote:
>     All that matters is that if I say "word" should be linked to "/word"
>     that in the HTML the <a> element has a @href of "/word"
>
> Ok, then it should be @uref.

Right, with you. Thanks.

>     What is the difference between "Some File" and "My Little Document"?
>
> My Little Document is the title of just the Top node, while Some File is
> the title of the whole document, e.g., it appears in the headers of the
> printed manual.  The manual explains a bit more.

Aha. Is it permissible to leave out the explicit top node?

Apologies if this is in the documentation, I have read through some of the
subsections but not the whole manual. I guess I should drop this line of
questioning until I get around to that, so forgive me! :)

> Which reminds me, if you're planning on making PDF (or DVI) from the
> Texinfo (as I hope you are), there is a little more to talk about

Yeps, but we'll cross that bridge when we get to it. Heh.

>     In my experiments I just left it out on the second mention of the
>     title and it seemed to copy the value from @settitle command.
>
> In makeinfo or texi2html or both?  Hmm, I didn't know that would happen.
> For your case, I can see it makes sense to only specify the title once.
> We should probably document it as a feature.

Just makeinfo, I have not installed texi2html yet -- but this is a priority for
me over the holidays. This was as a result of me wanting to leave out any node
declarations for very simple documents, but the bits of the manual I read didn't
seem to be very explicit about if that was allowed, or how it would be
handled. I appreciate that Texinfo is aimed at larger documents, so sorry if
some of these questions seem a little strange!

Thanks,

-- 
Noah Slater, http://tumbolia.org/nslater