Description of Problem: The man page contains single quotes in disallowed places, it seems. Also, the formatting could be better. Version-Release number of selected component (if applicable): 2.4.5-1
Created attachment 33478 [details] Here is a better xmlcatalog.1.
Argh ... it was contributed by John Fleck <jfleck> (and IIRC generated automatically from DocBook using XSLT), I will point John at this he may have to fix his stylesheet. How did you get the error ? Daniel
Ah, generated: I might have known. :-) Okay, the original problem came from looking at the --add section. Here's what it says: --add 'type' filename - Add an entry to catalog file file- name. type indicates the type of entry. Possible types are 'public', 'system', 'rewriteSystem', is the original ref- erence to be replaced, and 'replace' is the URI of the replacement entity to be used. The -add option will not overwrite filename, outputing to stdout, unless --noout is used. The --add will always take three parameters even if some of the XML catalog constructs will have only a single argument. There is obviously text missing at ...'rewriteSystem', is the original... The .PP between each paragraph would be much better as a .TP, with the next line being the parameter stuff, and the next paragraph the description of it.
I'll deal with this.
Partial fix committed, dealing with the first part of the problem, the dropped words in the "--add" bit. The second part requires some more time with the stylesheet, as there are still some problems with the output.
Thanks to some stylesheet/DocBook advice from Martijn van Beers (LotR - what is it the hip youngsters say - "shoutz to LotR"?) I believe this is fixed in CVS. Could you take a look, Tim?
It's still not quite right. It looks like this: .TP \fB--shell\fR \fIfilename\fR .PP Run a shell allowing interactive queries on catalog file \fIfilename\fR. The .PP line shouldn't be there; instead it should look like this: .TP \fB--shell\fR \fIfilename\fR Run a shell allowing interactive queries on catalog file \fIfilename\fR.
OK, another fix attempted. Could you give it another look, Tim?
(1.3 still seems to be the latest revision, which is what I have commented on.)
1.4 is in there. Are you perhaps using anoncvs, which takes time to update? In any case, the section you mentioned above now reads: .TP \fB--shell\fR \fIfilename\fR Run a shell allowing interactive queries on catalog file \fIfilename\fR.
Yes, that looks better. (Although the blank line isn't needed either.) Thanks.
Okay this seems solved in CVS, an I think is embedded in libxslt 1.0.5 which should be in RawHide by now. Daniel