* some minor tweaks for building doc/man pages for nftables
@ 2014-03-12 9:34 Robert P. J. Day
2014-03-12 10:51 ` Arturo Borrero Gonzalez
0 siblings, 1 reply; 6+ messages in thread
From: Robert P. J. Day @ 2014-03-12 9:34 UTC (permalink / raw)
To: netfilter devel list
new here so not confident enough to submit any patches yet, but on
my fedora rawhide system, some notes on building the man page and PDF
docs.
* re: INSTALL file, on fedora, the package names are actually:
* docbook2x -> docbook2X
* docbook-utils -> docbook-utils-pdf
* re: Makefile and configure, command to generate man output:
* docbook2x-man -> db2x_docbook2man
* in doc directory, man page currently refers to "nftables" command,
shouldn't that be just "nft" (both filename and contents of
doc/nftables.xml).
rday
--
========================================================================
Robert P. J. Day Ottawa, Ontario, CANADA
http://crashcourse.ca
Twitter: http://twitter.com/rpjday
LinkedIn: http://ca.linkedin.com/in/rpjday
========================================================================
^ permalink raw reply [flat|nested] 6+ messages in thread* Re: some minor tweaks for building doc/man pages for nftables
2014-03-12 9:34 some minor tweaks for building doc/man pages for nftables Robert P. J. Day
@ 2014-03-12 10:51 ` Arturo Borrero Gonzalez
2014-03-12 11:03 ` Robert P. J. Day
2014-03-26 10:32 ` Patrick McHardy
0 siblings, 2 replies; 6+ messages in thread
From: Arturo Borrero Gonzalez @ 2014-03-12 10:51 UTC (permalink / raw)
To: Robert P. J. Day; +Cc: netfilter devel list
On 12 March 2014 10:34, Robert P. J. Day <rpjday@crashcourse.ca> wrote:
>
> new here so not confident enough to submit any patches yet, but on
> my fedora rawhide system, some notes on building the man page and PDF
> docs.
>
Hi there!
Feel free to submit patches, but maybe this is an issue for Fedora
packagers to fix.
regards.
--
Arturo Borrero González
--
To unsubscribe from this list: send the line "unsubscribe netfilter-devel" in
the body of a message to majordomo@vger.kernel.org
More majordomo info at http://vger.kernel.org/majordomo-info.html
^ permalink raw reply [flat|nested] 6+ messages in thread
* Re: some minor tweaks for building doc/man pages for nftables
2014-03-12 10:51 ` Arturo Borrero Gonzalez
@ 2014-03-12 11:03 ` Robert P. J. Day
2014-03-12 11:14 ` Arturo Borrero Gonzalez
2014-03-26 10:32 ` Patrick McHardy
1 sibling, 1 reply; 6+ messages in thread
From: Robert P. J. Day @ 2014-03-12 11:03 UTC (permalink / raw)
To: Arturo Borrero Gonzalez; +Cc: netfilter devel list
On Wed, 12 Mar 2014, Arturo Borrero Gonzalez wrote:
> On 12 March 2014 10:34, Robert P. J. Day <rpjday@crashcourse.ca> wrote:
> >
> > new here so not confident enough to submit any patches yet, but on
> > my fedora rawhide system, some notes on building the man page and PDF
> > docs.
> >
>
> Hi there!
>
> Feel free to submit patches, but maybe this is an issue for Fedora
> packagers to fix.
quite possibly some of it, but surely the "nftables.xml" file under
doc/ should be updated to reflect that the command is now "nft", not
"nftables", no?
anyway, i'll leave this in the hands of the powers-that-be on this
list.
rday
--
========================================================================
Robert P. J. Day Ottawa, Ontario, CANADA
http://crashcourse.ca
Twitter: http://twitter.com/rpjday
LinkedIn: http://ca.linkedin.com/in/rpjday
========================================================================
^ permalink raw reply [flat|nested] 6+ messages in thread* Re: some minor tweaks for building doc/man pages for nftables
2014-03-12 11:03 ` Robert P. J. Day
@ 2014-03-12 11:14 ` Arturo Borrero Gonzalez
2014-03-12 12:16 ` Robert P. J. Day
0 siblings, 1 reply; 6+ messages in thread
From: Arturo Borrero Gonzalez @ 2014-03-12 11:14 UTC (permalink / raw)
To: Robert P. J. Day; +Cc: netfilter devel list
On 12 March 2014 12:03, Robert P. J. Day <rpjday@crashcourse.ca> wrote:
> quite possibly some of it, but surely the "nftables.xml" file under
> doc/ should be updated to reflect that the command is now "nft", not
> "nftables", no?
>
In Debian, my plan is to provide the same man page both for 'nft' and
'nftables' (one being a symlink to the other).
> anyway, i'll leave this in the hands of the powers-that-be on this
> list.
>
In the docbook side, you could try to find a solution that covers
all/most-important distributions.
I would suggest to simply send patches so we can review your ideas.
regards.
--
Arturo Borrero González
--
To unsubscribe from this list: send the line "unsubscribe netfilter-devel" in
the body of a message to majordomo@vger.kernel.org
More majordomo info at http://vger.kernel.org/majordomo-info.html
^ permalink raw reply [flat|nested] 6+ messages in thread
* Re: some minor tweaks for building doc/man pages for nftables
2014-03-12 11:14 ` Arturo Borrero Gonzalez
@ 2014-03-12 12:16 ` Robert P. J. Day
0 siblings, 0 replies; 6+ messages in thread
From: Robert P. J. Day @ 2014-03-12 12:16 UTC (permalink / raw)
To: Arturo Borrero Gonzalez; +Cc: netfilter devel list
On Wed, 12 Mar 2014, Arturo Borrero Gonzalez wrote:
> On 12 March 2014 12:03, Robert P. J. Day <rpjday@crashcourse.ca> wrote:
> > quite possibly some of it, but surely the "nftables.xml" file
> > under doc/ should be updated to reflect that the command is now
> > "nft", not "nftables", no?
> >
>
> In Debian, my plan is to provide the same man page both for 'nft'
> and 'nftables' (one being a symlink to the other).
ok, that sounds fine but, just for the record, the *official*
userspace command name is "nft", is it not? so linking to a man page
that purports to explain "nftables" is going to be a bit confusing.
> > anyway, i'll leave this in the hands of the powers-that-be on
> > this list.
>
> In the docbook side, you could try to find a solution that covers
> all/most-important distributions. I would suggest to simply send
> patches so we can review your ideas.
i'll see what i can come up with that isn't distro-specific.
rday
--
========================================================================
Robert P. J. Day Ottawa, Ontario, CANADA
http://crashcourse.ca
Twitter: http://twitter.com/rpjday
LinkedIn: http://ca.linkedin.com/in/rpjday
========================================================================
^ permalink raw reply [flat|nested] 6+ messages in thread
* Re: some minor tweaks for building doc/man pages for nftables
2014-03-12 10:51 ` Arturo Borrero Gonzalez
2014-03-12 11:03 ` Robert P. J. Day
@ 2014-03-26 10:32 ` Patrick McHardy
1 sibling, 0 replies; 6+ messages in thread
From: Patrick McHardy @ 2014-03-26 10:32 UTC (permalink / raw)
To: Arturo Borrero Gonzalez; +Cc: Robert P. J. Day, netfilter devel list
On Wed, Mar 12, 2014 at 11:51:26AM +0100, Arturo Borrero Gonzalez wrote:
> On 12 March 2014 10:34, Robert P. J. Day <rpjday@crashcourse.ca> wrote:
> >
> > new here so not confident enough to submit any patches yet, but on
> > my fedora rawhide system, some notes on building the man page and PDF
> > docs.
> >
>
> Hi there!
>
> Feel free to submit patches, but maybe this is an issue for Fedora
> packagers to fix.
I have fixes for the build and an manpage update coming up. Will push during
the next couple of days.
^ permalink raw reply [flat|nested] 6+ messages in thread
end of thread, other threads:[~2014-03-26 10:32 UTC | newest]
Thread overview: 6+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2014-03-12 9:34 some minor tweaks for building doc/man pages for nftables Robert P. J. Day
2014-03-12 10:51 ` Arturo Borrero Gonzalez
2014-03-12 11:03 ` Robert P. J. Day
2014-03-12 11:14 ` Arturo Borrero Gonzalez
2014-03-12 12:16 ` Robert P. J. Day
2014-03-26 10:32 ` Patrick McHardy
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).