Re: Text not showing up

Heime via Users list for the Texinfo documentation system <[email protected]> Sat, 17 May 2025 12:06:19 +0000
Newsgroups gmane.comp.tex.texinfo.general
Message-ID <is6O5JdNf2pGJXS4_nalC4nmKoONTktogiDFQtO3gkwuCQVeSxFenNC7-2V7Nc4Fhr15v8-ZvUlayeuBA7hsuyY4_hYFbKXrJA80ajgtkuU=@protonmail.com>




Sent with Proton Mail secure email.

On Saturday, May 17th, 2025 at 9:53 PM, Patrice Dumas <[email protected]> wrote:

> On Sat, May 17, 2025 at 02:15:22AM +0000, Heime via Users list for the Texinfo documentation system wrote:
> 
> > Have made an info file but not sure whether it has been made correctly.
> > I do not get the text I have written.
> 
> 
> There are no @node in your manual. If you convert to Info format,
> by calling for instance
> 
> texi2any icord.texi
> 
> you will get a warning:
> icord.texi: warning: document without nodes
> 
> and you will get an output Info file that shows nothing upon reading in
> an Info reader, as there are no nodes. If you convert to plaintext,
> PDF, or HTML you get something in output, though, for HTML, not split at
> nodes, but everything on one HTML page.
> 
> Another issue is that there is no @top command (nor @node Top).
> 
> If you do not want to add nodes manually, you can have texi2any insert them
> automatically, but you will still need a @top to have a @node Top
> created automatically such that the Info reader can find the first node.
> 
> texi2any -c TREE_TRANSFORMATIONS=insert_nodes_for_sectioning_commands icord.texi
> 
> Note that you can still starts with a given node, but it is not the
> usual way to use the Info format.
> 
> info ./icord.info -n Introduction
> 
> --
> Pat

Can you show me the basic structure of including nodes?  Would I need both a "@top" 
and "@node Top"?

Would like to introduce the nodes manually so I can see how things fit in together,
rather than having texi2any insert them automatically.