netdev - kernel doc / docbook pdfdocs question

lists.openwall.net		lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening linux-cve-announce PHC
Open Source and information security mailing list archives

Hash Suite: Windows password security audit tool. GUI, reports in PDF.

[<prev] [next>] [thread-next>] [day] [month] [year] [list]

Message-ID: <8223.1254340776@jerryjeff.riw.enoyolf.org>
Date:	Wed, 30 Sep 2009 14:59:36 -0500
From:	Doug Maxey <dwm@...yolf.org>
To:	Randy Dunlap <randy.dunlap@...cle.com>
cc:	netdev <netdev@...r.kernel.org>
Subject: kernel doc / docbook pdfdocs question

Randy,

This may be slightly off topic for this list, but it does involve an
(as yet un-released) network driver. :)

Do you have any insight that could guide me toward a fix for an issue
seen with some header file constructs when trying to generate a pdf
docbook?

In my .tmpl file I do the "process my header file" construct:
...
!Ipath/to/myheader.h
...

In myheader.h an example decl that is giving me fits looks like:

struct foo {
	int bar;
	DECLARE_BITMAP(baz, LENGTH);
	int fotz;
};

It puts the bar and fotz decls in the output, but only outputs a
warning to stderr on the line with DECLARE_BITMAP, nothing about baz
(or DECLARE_BITMAP) is output into the .xml file.

My question is, would it be easier to pre-process the header, say with
gcc -EC via some rule in Documentation/DocBook/Makefile, or to try and
fix whatever gets called by scripts/basic/docbook?

I tried to find what the exact calling sequence was, but am getting
lost in what actually does the xml generation, and therefore how to
fix what is choking on the DECLARE_BITMAP.

Any tips will be very appreciated!

++doug

--
To unsubscribe from this list: send the line "unsubscribe netdev" in
the body of a message to majordomo@...r.kernel.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html