about docbook2man (docbook2man-spec.pl)

about docbook2man (docbook2man-spec.pl)

[Philippe Batailler]

Hello,
When using package docbook-utils, version 0.6.11, and docbook2man to
create a manpage, the output shows "NAME" for every language.
It should be localized.

Also, the non breakable space, nbsp, is handled like a simple space; 
and, for french language, we need a declaration of "thinsp".

What do you think of the kind of patch I attach to this mail ?

Please, cc me.
Regards,

-- 
philippe batailler
in girum imus nocte et consumimur igni

-----------------------------------------------
--- docbook2man-spec.pl Thu Jul 25 22:55:11 2002
+++ docbook2man-spec.pl.new     Thu Jul 25 22:59:57 2002
@@ -344,7 +344,16 @@


 # NAME section
-man_sgml('<REFNAMEDIV>', "\n.SH NAME\n");
+# one can add key-value pair in '%words'
+# and the good 'name' will be printed.
+man_sgml('<REFNAMEDIV>', sub {
+        my %words = qw( fr NOM es NOMBRE de NAME );
+        if (defined($_[0]->attribute('LANG')->value)) {
+        my $id = $_[0]->attribute('LANG')->value;
+        my $ad = $words{$id};
+        output("\n.SH $ad\n");}
+        else {output("\n.SH NAME\n");}
+});

 sgml('<REFNAME>', \&save_cdata);
 sgml('</REFNAME>', sub {
@@ -1154,7 +1163,8 @@
 man_sgml('|[lt    ]|', '<');
 man_sgml('|[gt    ]|', '>');
 man_sgml('|[amp   ]|', '&');
-man_sgml('|[nbsp  ]|', ' ');
+man_sgml('|[nbsp  ]|', '\~');
+man_sgml('|[thinsp  ]|', '\~');

 #
 # Default handlers (uncomment these if needed).  Right now, these are set

Re: about docbook2man (docbook2man-spec.pl)

[Tim Waugh]

[-- Attachment #1: Type: text/plain, Size: 692 bytes --]

On Sat, Jul 27, 2002 at 05:55:52PM +0200, Philippe Batailler wrote:

> Hello,
> When using package docbook-utils, version 0.6.11, and docbook2man to
> create a manpage, the output shows "NAME" for every language.
> It should be localized.

Good point.

> What do you think of the kind of patch I attach to this mail ?

Good, except for this bit:

> +        my $id = $_[0]->attribute('LANG')->value;

We need to use the current value of the 'lang' attribute for this.
For example:

<refentry lang="de">
  ...
</refentry>
<refentry lang="es">
  ...
</refentry>

So we need to look for the 'lang' attribute on the ancestor nodes.

I have applied the nbsp and thinsp handlers---thanks.

Tim.
*/

[-- Attachment #2: Type: application/pgp-signature, Size: 232 bytes --]

about docbook2man (docbook2man-spec.pl)

[Philippe Batailler]

Hello,
When using package docbook-utils, version 0.6.11, and docbook2man to
create a manpage, the output shows "NAME" for every language.
It should be localized.

Also, the non breakable space, nbsp, is handled like a simple space; 
and, for french language, we need a declaration of "thinsp".

What do you think of the kind of patch I attach to this mail ?

Please, cc me.
Regards,

-- 
philippe batailler
in girum imus nocte et consumimur igni

-----------------------------------------------
--- docbook2man-spec.pl Thu Jul 25 22:55:11 2002
+++ docbook2man-spec.pl.new     Thu Jul 25 22:59:57 2002
@@ -344,7 +344,16 @@


 # NAME section
-man_sgml('<REFNAMEDIV>', "\n.SH NAME\n");
+# one can add key-value pair in '%words'
+# and the good 'name' will be printed.
+man_sgml('<REFNAMEDIV>', sub {
+        my %words = qw( fr NOM es NOMBRE de NAME );
+        if (defined($_[0]->attribute('LANG')->value)) {
+        my $id = $_[0]->attribute('LANG')->value;
+        my $ad = $words{$id};
+        output("\n.SH $ad\n");}
+        else {output("\n.SH NAME\n");}
+});

 sgml('<REFNAME>', \&save_cdata);
 sgml('</REFNAME>', sub {
@@ -1154,7 +1163,8 @@
 man_sgml('|[lt    ]|', '<');
 man_sgml('|[gt    ]|', '>');
 man_sgml('|[amp   ]|', '&');
-man_sgml('|[nbsp  ]|', ' ');
+man_sgml('|[nbsp  ]|', '\~');
+man_sgml('|[thinsp  ]|', '\~');

 #
 # Default handlers (uncomment these if needed).  Right now, these are set

Re: about docbook2man (docbook2man-spec.pl)

[Tim Waugh]

[-- Attachment #1: Type: text/plain, Size: 692 bytes --]

On Sat, Jul 27, 2002 at 05:55:52PM +0200, Philippe Batailler wrote:

> Hello,
> When using package docbook-utils, version 0.6.11, and docbook2man to
> create a manpage, the output shows "NAME" for every language.
> It should be localized.

Good point.

> What do you think of the kind of patch I attach to this mail ?

Good, except for this bit:

> +        my $id = $_[0]->attribute('LANG')->value;

We need to use the current value of the 'lang' attribute for this.
For example:

<refentry lang="de">
  ...
</refentry>
<refentry lang="es">
  ...
</refentry>

So we need to look for the 'lang' attribute on the ancestor nodes.

I have applied the nbsp and thinsp handlers---thanks.

Tim.
*/

[-- Attachment #2: Type: application/pgp-signature, Size: 232 bytes --]