Re: Text not showing up

[Heime via Users list for the Texinfo documentation system]

Sent with Proton Mail secure email.

On Saturday, May 17th, 2025 at 9:53 PM, Patrice Dumas <pertu...@free.fr> 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.