Re: Simple documents and DocBook output

[Noah Slater]

On Tue, Dec 23, 2008 at 07:45:32PM -0600, Karl Berry wrote:
>     the makeinfo command generated a DocBook file with my text in the
>     <abstract> I figured that there was some recommended way to produce
>     a simple document with only one root section.
>
> Nah, docbook support just isn't especially well developed or thought
> out.  We will rely on you to improve it :).

Great, I'm up for that! I actually have a ton of questions I've noted down as I
have been playing with Texinfo, but I'm trying my best not to spam your lovely
mailing list! Hehe.

> The impedance mismatch that comes to mind is the cross-file links.
> That's obviously common and simple in web sites.  You wouldn't want to
> use five-argument @xrefs to do it in Texinfo.  I'm not sure what the
> answer is.

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", it's really not important for the
Texinfo layer to understand what this hyperlink is referring to as I'm not
wanting to generate in-document xrefs or transclusion.

Unless I'm missing something?

> Here is a realistic minimal file (untested) for your scenario:
>
> \input texinfo
> @setfilename somefile.info
> @setitle Some File
>
> @copying
> Copyright blah blah
> @end copying
>
> @node Top
> @top My Little Document
>
> My little document does the job.
>
> @bye

Great! What is the difference between "Some File" and "My Little Document"? Why
would these two be separate, is there any way for me to only say this once and
have it apply to both. 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.

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