abcl icon indicating copy to clipboard operation
abcl copied to clipboard

abcl.texi

Open alanruttenberg opened this issue 4 years ago • 2 comments

Is this maintained? I was recently curious about what the documentation was like in info so I tried makeinfo-buffer, but there were errors. Looking at the file date, perhaps it is obsolete. If so, I'd propose removing it from the distribution.

-*- mode: compilation; default-directory: "~/repos/abcl/doc/manual/" -*-
Compilation started at Thu Nov 11 15:43:10

makeinfo --fill-column=70 abcl.texi
abcl.texi:1344: warning: unlikely character ( in @var.
abcl.texi:1344: warning: unlikely character ) in @var.
/Users/alanr/repos/abcl/doc/manual//abcl.texi:1322: `Package-Local Nicknames' has no Up field (perhaps incorrect sectioning?).
/Users/alanr/repos/abcl/doc/manual//abcl.texi:1322: warning: unreferenced node `Package-Local Nicknames'.
makeinfo: Removing output file `/Users/alanr/repos/abcl/doc/manual/abcl.info' due to errors; use --force to preserve.

Compilation exited abnormally with code 1 at Thu Nov 11 15:43:11

alanruttenberg avatar Nov 11 '21 20:11 alanruttenberg

Is this maintained?

No, it isn't maintained. I forget who contributed it and/or the tooling used to generate it, but at the time it was thought better to have something rather than nothing.

easye avatar Nov 11 '21 20:11 easye

I think that at this point, given that it doesn't build and the build isn't part of the Makefile, it being out of date is more of a liability and that you should consider removing it or, minimally, noting the problem of it being out of date in one of the readmes

alanruttenberg avatar Nov 13 '21 20:11 alanruttenberg