HTML templates and GNU manual pages

Most Gnu programs use Texinfo for their manuals. Most of them also have a nice online webpage introducting the documentation, such as: https://www.gnu.org/software/hello/manual/ I rather like seeing this in the Gnu livery and the coda at the foot of the page gives it a nice professional lookin

Re: rule for period and sentence ending

Possibly you are right. I think the answer is largely historical. That is how TeX works and has done for 30 years. The style wars regarding the placement of dots has always been a controversial one. Should one write : These are the methods of the N.S.A. or These are the methods of the N

Re: makeinfo 5.0 is 34x slower when building Emacs info

On Tue, Feb 19, 2013 at 06:25:08PM -0800, Paul Eggert wrote: Running Emacs's 'make info' takes 6.5 seconds with texinfo 4.13, but 224 seconds with texinfo 5.0, a factor of 34 slowdown. It's now quite a wait for me to run 'make info', and this is an annoyance -- can this be sped

Re: [bug-recutils] Recutils manual does not build.

On Tue, Feb 12, 2013 at 08:36:54PM +0100, Jose E. Marchesi wrote: /home/john/recutils/doc//recutils.texi:198: Cross reference to nonexistent node `Importing MDB files' (perhaps incorrect sectioning?). /home/john/recutils/doc//recutils.texi:177: Cross reference to nonexiste

Local Preferences in Texinfo files

On Sat, Feb 09, 2013 at 10:48:53PM +, Karl Berry wrote: A texinfo.cnf file is already read for this purpose but nobody uses it (that I've ever heard). I put an option -t into texi2dvi a couple of decades ago to allow adding local-preference commands without altering t

Re: texinfo-4.13.91 - undetected curses

On Sun, Dec 02, 2012 at 01:05:21AM +, Karl Berry wrote: Hi Ineiev, I tried to build it on cygwin; it didn't find ncurses [0], but configure exited successfully, and it was make that broke. Well, that is clearly a problem, but I can't possibly guess what t

Re: texinfo-4.13.90 pretest available

On Tue, Nov 20, 2012 at 12:01:43AM +, Karl Berry wrote: Probably because you saw only GNU/Linux systems. As I understand it, mingw is supposed to be providing a reasonable GNU/Unix-ish environment. I understood that too, and it is certainly the impression that the Mi

Re: texinfo-4.13.90 pretest available

On Mon, Nov 19, 2012 at 10:01:19PM +0100, Patrice Dumas wrote: On Mon, Nov 19, 2012 at 09:47:41PM +0100, John Darrington wrote: > I cannot reproduce that. Could you please paste the 'locale' command > result? > > > LANG=d

Re: texinfo-4.13.90 pretest available

On Mon, Nov 19, 2012 at 09:44:58PM +0100, Patrice Dumas wrote: On Mon, Nov 19, 2012 at 07:34:41PM +0100, John Darrington wrote: > On Fri, Nov 16, 2012 at 07:26:38PM +, Karl Berry wrote: > Finally, the first pretest for the next Texinfo release is ava

Re: texinfo-4.13.90 pretest available

On Fri, Nov 16, 2012 at 07:26:38PM +, Karl Berry wrote: Finally, the first pretest for the next Texinfo release is available: ftp://alpha.gnu.org/gnu/texinfo/texinfo-4.13.90.tar.xz http://alpha.gnu.org/gnu/texinfo/texinfo-4.13.90.tar.xz Please send any feedbac

Re: texinfo-4.13.90 pretest available

On Fri, Nov 16, 2012 at 07:26:38PM +, Karl Berry wrote: Finally, the first pretest for the next Texinfo release is available: ftp://alpha.gnu.org/gnu/texinfo/texinfo-4.13.90.tar.xz http://alpha.gnu.org/gnu/texinfo/texinfo-4.13.90.tar.xz Please send any feedbac

Re: Issues with gendocs and images

On Fri, Oct 19, 2012 at 09:54:28PM +, Karl Berry wrote: Hi Akim, A few images have been added to the Bison documentation Sorry to hear it. I doubt you can reasonably use gendocs in such circumstances, for all the reasons you have discovered. Anyway, I have

Broken docbook XML

makeinfo (GNU texinfo) 4.13 This input : \input texinfo @c -*- texinfo -*- @float Table, tab:tab2 @multitable @columnfractions .25 .25 @item Height(cm) @tab Gender @item 152.71 @tab 0 @end multitable @caption{Height of twelve year old children} @end float @bye when presented to "makeinfo --d

Re: [bug-recutils] Doc patch

[Cross posting to bug-gnu...@gnu.org, bug-texinfo@gnu.org and bug-recut...@gnu.org] On Fri, Aug 24, 2012 at 07:52:01AM +0200, Jose E. Marchesi wrote: Hi John. I suggest this patch. We are following the advise of Karl Berry and not using @acronym{} in the

Re: Commas in @example environment

On Sat, Aug 18, 2012 at 09:33:27PM +, Karl Berry wrote: It doesn't seem to be possible to insert a comma within a @example environment. Hi John, Need failing code please, the basic idea certainly works for me. There is nothing special about commas in an exa

Commas in @example environment

It doesn't seem to be possible to insert a comma within a @example environment. I have tried a literal , as well as @comma{} However in TeX output it always seems to get rendered as a space. J' -- PGP Public key ID: 1024D/2DE827B3 fingerprint = 8797 A26D 0854 2EAB 0285 A290 8A67 719C 2DE8

tags in HTML

Some of the non-english speaking PSPP users have been trying to use automatic translation tools to read the HTML generated from the PSPP manual's Texinfo source. Apparently many such tools make a point of not attempting to translate text between tags. So far as I can tell makeinfo only puts in

Re: makeinfo should quote 'like this' instead of `like this'

On Mon, Jan 23, 2012 at 05:20:42PM -0800, Karl Berry wrote: Yes, fine. But the question at hand is about the info/plaintext output for @file when enable-encoding is *not* set, and/or utf-8 is not specified,. Up till now, makeinfo in all its forms has output `foo'. But I

Re: Include paths for makeinfo

On Wed, Dec 21, 2011 at 11:57:37AM +0100, Patrice Dumas wrote: On Mon, Dec 19, 2011 at 03:43:40PM -0800, Karl Berry wrote: > > With this flag, it warns that picture.txt is missing, even though > it's not. In fact, it shouldn't be looking for that, but for > pi

Re: Include paths for makeinfo

On Sun, Dec 18, 2011 at 02:38:04PM -0800, Karl Berry wrote: Makeinfo doesn't seem to honour the -I flag when searching for the subject of @image Hmm, makeinfo 4.13 does use the -I args to search for images, or so it looks from the code. Can you sh

Re: Include paths for makeinfo

On Sun, Dec 18, 2011 at 10:46:33AM +0100, Patrice Dumas wrote: On Sun, Dec 18, 2011 at 08:52:47AM +, John Darrington wrote: > Makeinfo doesn't seem to honour the -I flag when searching for the > subject of @image > > I wasn't quire sure from t

Include paths for makeinfo

Makeinfo doesn't seem to honour the -I flag when searching for the subject of @image I wasn't quire sure from the documentation if it was actually supposed to. If not, then there needs to be an alternate way of specifying such a path. J' -- PGP Public key ID: 1024D/2DE827B3 fingerprint = 8797

@clicksequence

The manual for Texinfo 4.13 describes the command @clicksequence However when I try to use it, I get: /home/john/tutorial/doc/trial.texi:23: Undefined control sequence. l.23 @clicksequence {File @click{} New @click{} Syntax} to open a new syntax ... ? tex

Duplicate @setfilename commands

In makeinfo/cmds.c I see the following: /* I don't know exactly what to do with this. Should I allow someone to switch filenames in the middle of output? Since the file could be partially written, this doesn't seem to make sense. Another option: ignore it, since they don't really want

[bug #25822] @float without preceding whitespace produces broken docbook xml

URL: Summary: @float without preceding whitespace produces broken docbook xml Project: texinfo - GNU documentation system Submitted by: jmd Submitted on: Wed 11 Mar 2009 10:34:13 PM WST

[bug #25820] Ampersands in node names produces broken docbook xml

URL: Summary: Ampersands in node names produces broken docbook xml Project: texinfo - GNU documentation system Submitted by: jmd Submitted on: Wed 11 Mar 2009 10:07:18 PM WST Category

Bug/Undesirable behaviour in texinfo.tex

@title Foo @vskip 0pt plus 1filll @author John Darrington @sp 2 @end titlepage @contents @chapter Chapter One This is chapter one @chapter Chapter Two This is chapter two. @chapter Chapter Three This is chapter three. @bye I managed to patch texinfo.tex to make it work --- I'm not