2005-04-11 16:10:12

by Martin Waitz

Subject: [patch 1/2] Docbook: use custom stylesheet

Docbook: use custom stylesheet

With the custom stylesheet, functions are rendered using ANSI-C syntax
and xmlto is a bit quieter.

Signed-off-by: Martin Waitz <[email protected]>

---
Documentation/DocBook/Makefile | 3 ++-
Documentation/DocBook/stylesheet.xsl | 5 +++++
2 files changed, 7 insertions(+), 1 deletion(-)

Index: linux-docbook/Documentation/DocBook/Makefile
===================================================================
--- linux-docbook.orig/Documentation/DocBook/Makefile 2005-04-06 15:46:05.000000000 +0200
+++ linux-docbook/Documentation/DocBook/Makefile 2005-04-10 12:57:53.678951360 +0200
@@ -49,7 +49,8 @@ installmandocs: mandocs
KERNELDOC = scripts/kernel-doc
DOCPROC = scripts/basic/docproc

-#XMLTOFLAGS = --skip-validation
+XMLTOFLAGS = -m Documentation/DocBook/stylesheet.xsl
+#XMLTOFLAGS += --skip-validation

###
# DOCPROC is used for two purposes:
Index: linux-docbook/Documentation/DocBook/stylesheet.xsl
===================================================================
--- /dev/null 1970-01-01 00:00:00.000000000 +0000
+++ linux-docbook/Documentation/DocBook/stylesheet.xsl 2005-04-09 13:59:56.000000000 +0200
@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<stylesheet xmlns="http://www.w3.org/1999/XSL/Transform" version="1.0">
+<param name="chunk.quietly">1</param>
+<param name="funcsynopsis.style">ansi</param>
+</stylesheet>

--
Martin Waitz

2005-04-11 16:50:57

by Alexey Dobriyan

Subject: Re: [patch 1/2] Docbook: use custom stylesheet

On Monday 11 April 2005 15:58, Martin Waitz wrote:
> Docbook: use custom stylesheet
>
> With the custom stylesheet, functions are rendered using ANSI-C syntax
> and xmlto is a bit quieter.

Definitely better. Still remains (anything with more than 1 argument):
==================================================================
Synopsis

int bios_param (struct scsi_device * sdev,
struct block_device * bdev,
sector_t capacity,
int params[3]);

Arguments
==================================================================
Synopsis

int queuecommand (struct scsi_cmnd * scp,
void (* done) (struct scsi_cmnd *));

Arguments
==================================================================

Nice to see [TeX mode on] -- [TeX mode off] instead of "--" after function
name. ;-)

Second patch works.