Commit 45a93d3576de413dad5039306c48ec8bc95d0746

Thomas de Grivel 2023-01-21T15:08:42

help2man-1.39.4

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
diff --git a/README b/README
index 217d444..dca6263 100644
--- a/README
+++ b/README
@@ -1,10 +1,10 @@
-		README for GNU help2man version 1.39.3
+		README for GNU help2man version 1.39.4
 
 help2man is a script to create simple man pages from the --help and
 --version output of programs.
 
   http://www.gnu.org/software/help2man/
-  ftp://ftp.gnu.org/gnu/help2man/help2man-1.39.3.tar.gz
+  ftp://ftp.gnu.org/gnu/help2man/help2man-1.39.4.tar.gz
 
   git://git.debian.org/users/bod/help2man.git
   http://git.debian.org/?p=users/bod/help2man.git
diff --git a/debian/changelog b/debian/changelog
index 689b835..f6e332a 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -1,3 +1,9 @@
+help2man (1.39.4) unstable; urgency=low
+
+  * Update Italian translation (thanks to Sergio Zanchetta).
+
+ -- Brendan O'Dea <bod@debian.org>  Wed, 11 May 2011 22:58:55 +1000
+
 help2man (1.39.3) unstable; urgency=low
 
   * Update French translation (thanks to David Prévot, closes: #620250).
diff --git a/help2man.1 b/help2man.1
index 4c30a3a..416c690 100644
--- a/help2man.1
+++ b/help2man.1
@@ -1,5 +1,5 @@
-.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.39.3.
-.TH HELP2MAN "1" "May 2011" "help2man 1.39.3" "User Commands"
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.39.4.
+.TH HELP2MAN "1" "May 2011" "help2man 1.39.4" "User Commands"
 .SH NAME
 help2man \- generate a simple manual page
 .SH SYNOPSIS
diff --git a/help2man.PL b/help2man.PL
index 75da9e2..39a3fb1 100755
--- a/help2man.PL
+++ b/help2man.PL
@@ -16,7 +16,7 @@ use 5.008;
 use Config;
 use Getopt::Long;
 
-my ($program, $version) = ('help2man', '1.39.3');
+my ($program, $version) = ('help2man', '1.39.4');
 
 my %opts;
 die "Usage: $0 [--quiet] [--stdout] [--with-gettext] [--name] [--version]\n"
diff --git a/help2man.de.1 b/help2man.de.1
index ce7b42a..1f8e5e3 100644
--- a/help2man.de.1
+++ b/help2man.de.1
@@ -1,5 +1,5 @@
-.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.39.3.
-.TH HELP2MAN "1" "Mai 2011" "help2man 1.39.3" "Benutzerkommandos"
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.39.4.
+.TH HELP2MAN "1" "Mai 2011" "help2man 1.39.4" "Benutzerkommandos"
 .SH NAME
 help2man \- generiert eine einfache Handbuchseite
 .SH ÜBERSICHT
diff --git a/help2man.el.1 b/help2man.el.1
index dadceb4..90e9768 100644
--- a/help2man.el.1
+++ b/help2man.el.1
@@ -1,5 +1,5 @@
-.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.39.3.
-.TH HELP2MAN "1" "Μάιος 2011" "help2man 1.39.3" "Εντολές χρήστη"
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.39.4.
+.TH HELP2MAN "1" "Μάιος 2011" "help2man 1.39.4" "Εντολές χρήστη"
 .SH NAME
 help2man \- δημιουργία απλής σελίδας εγχειριδίου
 .SH DESCRIPTION
diff --git a/help2man.eo.1 b/help2man.eo.1
index 0e07834..6260484 100644
--- a/help2man.eo.1
+++ b/help2man.eo.1
@@ -1,5 +1,5 @@
-.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.39.3.
-.TH HELP2MAN "1" "Majo 2011" "help2man 1.39.3" "Uzant-Komandoj"
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.39.4.
+.TH HELP2MAN "1" "Majo 2011" "help2man 1.39.4" "Uzant-Komandoj"
 .SH NOMO
 help2man \- generas simplan man-paĝon
 .SH RESUMO
diff --git a/help2man.fi.1 b/help2man.fi.1
index f9394c7..5a025fb 100644
--- a/help2man.fi.1
+++ b/help2man.fi.1
@@ -1,5 +1,5 @@
-.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.39.3.
-.TH HELP2MAN "1" "toukokuu 2011" "help2man 1.39.3" "Käyttäjän sovellukset"
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.39.4.
+.TH HELP2MAN "1" "toukokuu 2011" "help2man 1.39.4" "Käyttäjän sovellukset"
 .SH NIMI
 help2man \- luo yksinkertainen man-sivu
 .SH YLEISKATSAUS
diff --git a/help2man.fr.1 b/help2man.fr.1
index 4a5d9cc..657635c 100644
--- a/help2man.fr.1
+++ b/help2man.fr.1
@@ -1,5 +1,5 @@
-.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.39.3.
-.TH HELP2MAN "1" "mai 2011" "help2man 1.39.3" "Commandes"
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.39.4.
+.TH HELP2MAN "1" "mai 2011" "help2man 1.39.4" "Commandes"
 .SH NOM
 help2man \- crée une page de manuel sommaire
 .SH SYNOPSIS
diff --git a/help2man.info b/help2man.info
index 7e74b0f..8643583 100644
--- a/help2man.info
+++ b/help2man.info
@@ -43,6 +43,7 @@ File: help2man.info,  Node: Top,  Next: Overview,  Up: (dir)
 * --help recommendations::      Recommended formatting for --help output.
 * Makefile usage::              Using `help2man' with `make'.
 * Localised man pages::         Producing native language manual pages.
+* Example::                     Example `help2man' output.
 * Reports::                     Reporting bugs or suggestions.
 * Availability::                Obtaining `help2man'.
 
@@ -314,7 +315,7 @@ included in the distribution without requiring the end-user to have
    for `autoconf' alone.
 
 
-File: help2man.info,  Node: Localised man pages,  Next: Reports,  Prev: Makefile usage,  Up: Top
+File: help2man.info,  Node: Localised man pages,  Next: Example,  Prev: Makefile usage,  Up: Top
 
 6 Producing Native Language Manual Pages.
 *****************************************
@@ -366,9 +367,103 @@ languages currently supported by `help2man', and *note Reports:: for
 how to submit other translations.
 
 
-File: help2man.info,  Node: Reports,  Next: Availability,  Prev: Localised man pages,  Up: Top
+File: help2man.info,  Node: Example,  Next: Reports,  Prev: Localised man pages,  Up: Top
 
-7 Reporting Bugs or Suggestions
+7 Example `help2man' Output
+***************************
+
+Given a hypothetical program `foo' which produces the following output:
+
+     $ foo --version
+     GNU foo 1.1
+
+     Copyright (C) 2011 Free Software Foundation, Inc.
+     This is free software; see the source for copying conditions.  There is NO
+     warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
+
+     Written by A. Programmer.
+     $ foo --help
+     GNU `foo' does nothing interesting except serve as an example for
+     `help2man'.
+
+     Usage: foo [OPTION]...
+
+     Options:
+       -a, --option      an option
+       -b, --another-option[=VALUE]
+                         another option
+
+           --help        display this help and exit
+           --version     output version information and exit
+
+     Examples:
+       foo               do nothing
+       foo --option      the same thing, giving `--option'
+
+     Report bugs to <bug-gnu-utils@gnu.org>.
+
+   `help2man' will produce `nroff' input for a manual page which will
+be formatted something like this:
+
+     FOO(1)                         User Commands                        FOO(1)
+
+
+     NAME
+            foo - manual page for foo 1.1
+
+     SYNOPSIS
+            foo [OPTION]...
+
+     DESCRIPTION
+            GNU  `foo'  does nothing interesting except serve as an example for
+            `help2man'.
+
+     OPTIONS
+            -a, --option
+                   an option
+
+            -b, --another-option[=VALUE]
+                   another option
+
+            --help display this help and exit
+
+            --version
+                   output version information and exit
+
+     EXAMPLES
+            foo    do nothing
+
+            foo --option
+                   the same thing, giving `--option'
+
+     AUTHOR
+            Written by A. Programmer.
+
+     REPORTING BUGS
+            Report bugs to <bug-gnu-utils@gnu.org>.
+
+     COPYRIGHT
+            Copyright (C) 2011 Free Software Foundation, Inc.
+            This is free software;  see  the  source  for  copying  conditions.
+            There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A
+            PARTICULAR PURPOSE.
+
+     SEE ALSO
+            The full documentation for foo is maintained as a  Texinfo  manual.
+            If  the  info and foo programs are properly installed at your site,
+            the command
+
+                   info foo
+
+            should give you access to the complete manual.
+
+
+     foo 1.1                          May 2011                           FOO(1)
+
+
+File: help2man.info,  Node: Reports,  Next: Availability,  Prev: Example,  Up: Top
+
+8 Reporting Bugs or Suggestions
 *******************************
 
 If you find problems or have suggestions about this program or manual,
@@ -381,7 +476,7 @@ Project (http://translationproject.org/) see
 
 File: help2man.info,  Node: Availability,  Prev: Reports,  Up: Top
 
-8 Obtaining `help2man'
+9 Obtaining `help2man'
 **********************
 
 The latest version of this distribution is available on-line from:
@@ -392,14 +487,15 @@ The latest version of this distribution is available on-line from:
 
 Tag Table:
 Node: Top1137
-Node: Overview1844
-Node: Invoking help2man2551
-Node: --help recommendations4902
-Node: Including text8320
-Node: Makefile usage10031
-Node: Localised man pages10970
-Ref: Localised man pages-Footnote-112675
-Node: Reports12851
-Node: Availability13317
+Node: Overview1903
+Node: Invoking help2man2610
+Node: --help recommendations4961
+Node: Including text8379
+Node: Makefile usage10090
+Node: Localised man pages11029
+Ref: Localised man pages-Footnote-112734
+Node: Example12910
+Node: Reports15515
+Node: Availability15969
 
 End Tag Table
diff --git a/help2man.it.1 b/help2man.it.1
index 6455137..c540eeb 100644
--- a/help2man.it.1
+++ b/help2man.it.1
@@ -1,73 +1,72 @@
-.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.39.3.
-.TH HELP2MAN "1" "maggio 2011" "help2man 1.39.3" "Comandi utente"
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.39.4.
+.TH HELP2MAN "1" "maggio 2011" "help2man 1.39.4" "Comandi utente"
 .SH NOME
 help2man \- genera una semplice pagina di manuale
+.SH SINTASSI
+.B help2man
+[\fIOPZIONE\fR]... \fIESEGUIBILE\fR
 .SH DESCRIZIONE
-`help2man' generates a man page out of `\-\-help' and `\-\-version' output.
-.PP
-Usage: help2man [OPTION]... EXECUTABLE
+"help2man" genera una pagina man dall'output di "\-\-help" e "\-\-version".
 .TP
-\fB\-n\fR, \fB\-\-name\fR=\fISTRING\fR
-description for the NAME paragraph
+\fB\-n\fR, \fB\-\-name\fR=\fISTRINGA\fR
+Descrizione per il paragrafo NOME
 .TP
-\fB\-s\fR, \fB\-\-section\fR=\fISECTION\fR
-section number for manual page (1, 6, 8)
+\fB\-s\fR, \fB\-\-section\fR=\fISEZIONE\fR
+Numero di sezione per la pagina di manuale (1, 6, 8)
 .TP
-\fB\-m\fR, \fB\-\-manual\fR=\fITEXT\fR
-name of manual (User Commands, ...)
+\fB\-m\fR, \fB\-\-manual\fR=\fITESTO\fR
+Nome del manuale (Comandi utente, ...)
 .TP
-\fB\-S\fR, \fB\-\-source\fR=\fITEXT\fR
-source of program (FSF, Debian, ...)
+\fB\-S\fR, \fB\-\-source\fR=\fITESTO\fR
+Provenienza del programma (FSF, Debian, ...)
 .TP
-\fB\-L\fR, \fB\-\-locale\fR=\fISTRING\fR
-select locale (default "C")
+\fB\-L\fR, \fB\-\-locale\fR=\fISTRINGA\fR
+Seleziona la localizzazione (predefinita "C")
 .TP
 \fB\-i\fR, \fB\-\-include\fR=\fIFILE\fR
-include material from `FILE'
+Include il materiale proveniente dal "FILE"
 .TP
 \fB\-I\fR, \fB\-\-opt\-include\fR=\fIFILE\fR
-include material from `FILE' if it exists
+Include il materiale proveniente dal "FILE" se esiste
 .TP
 \fB\-o\fR, \fB\-\-output\fR=\fIFILE\fR
-send output to `FILE'
+Invia l'output su "FILE"
 .TP
-\fB\-p\fR, \fB\-\-info\-page\fR=\fITEXT\fR
-name of Texinfo manual
+\fB\-p\fR, \fB\-\-info\-page\fR=\fITESTO\fR
+Nome del manuale Texinfo
 .TP
 \fB\-N\fR, \fB\-\-no\-info\fR
-suppress pointer to Texinfo manual
+Elimina il riferimento al manuale Texinfo
 .TP
 \fB\-l\fR, \fB\-\-libtool\fR
-exclude the `lt\-' from the program name
+Esclude "lt\-" dal nome del programma
 .TP
 \fB\-\-help\fR
-print this help, then exit
+Stampa questo aiuto ed esce
 .TP
 \fB\-\-version\fR
-print version number, then exit
+Stampa il numero di versione ed esce
 .PP
-EXECUTABLE should accept `\-\-help' and `\-\-version' options and produce output on
-stdout although alternatives may be specified using:
+L'ESEGUIBILE dovrebbe accettare le opzioni "\-\-help" e "\-\-version" e produrre output su
+stdout sebbene le alternative possano essere specificate usando:
 .TP
-\fB\-h\fR, \fB\-\-help\-option\fR=\fISTRING\fR
-help option string
+\fB\-h\fR, \fB\-\-help\-option\fR=\fISTRINGA\fR
+Stringa con opzione alternativa per l'aiuto
 .TP
-\fB\-v\fR, \fB\-\-version\-option\fR=\fISTRING\fR
-version option string
+\fB\-v\fR, \fB\-\-version\-option\fR=\fISTRINGA\fR
+Stringa con opzione alternativa per la versione
 .TP
-\fB\-\-version\-string\fR=\fISTRING\fR
-version string
+\fB\-\-version\-string\fR=\fISTRINGA\fR
+Stringa della versione
 .TP
 \fB\-\-no\-discard\-stderr\fR
-include stderr when parsing option output
-.PP
-Report bugs to <bug\-help2man@gnu.org>.
+Include lo stderr nell'analisi dell'output dell'opzione
 .SH "FILE DI INCLUSIONE"
 Nell'output generato possono essere inclusi materiali aggiuntivi con le opzioni
 .B \-\-include
 e
-.BR \-\-opt\-include .
-Il formato è semplice:
+.B \-\-opt\-include
+.  Il formato è semplice:
 
     [sezione]
     testo
@@ -128,13 +127,17 @@ per le sezioni standard fornite precedentemente, oppure sono incluse in
 L'ultima versione di questa distribuzione è disponibile online su:
 
     ftp://ftp.gnu.org/gnu/help2man/
+.SH AUTORE
+Scritto da Brendan O'Dea <bod@debian.org>
+.SH "SEGNALAZIONE BUG"
+Segnalare i bug a <bug\-help2man@gnu.org>.
 .SH COPYRIGHT
 Copyright \(co 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2009, 2010,
 2011 Free Software Foundation, Inc.
-This is free software; see the source for copying conditions.  There is NO
-warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
-.PP
-Written by Brendan O'Dea <bod@debian.org>
+.br
+Questo è software libero; si vedano i sorgenti per le condizioni di copia.
+NON c'è alcuna garanzia; neppure di COMMERCIABILITÀ o di IDONEITÀ A UNO
+SCOPO PARTICOLARE.
 .SH "VEDERE ANCHE"
 L'intera documentazione di
 .B help2man
diff --git a/help2man.pl.1 b/help2man.pl.1
index df3e64c..b51c819 100644
--- a/help2man.pl.1
+++ b/help2man.pl.1
@@ -1,5 +1,5 @@
-.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.39.3.
-.TH HELP2MAN "1" "maj 2011" "help2man 1.39.3" "Polecenia użytkownika"
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.39.4.
+.TH HELP2MAN "1" "maj 2011" "help2man 1.39.4" "Polecenia użytkownika"
 .SH NAZWA
 help2man \- generowanie prostej strony podręcznika
 .SH SKŁADNIA
diff --git a/help2man.pt_BR.1 b/help2man.pt_BR.1
index 3a9944c..336217c 100644
--- a/help2man.pt_BR.1
+++ b/help2man.pt_BR.1
@@ -1,5 +1,5 @@
-.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.39.3.
-.TH HELP2MAN "1" "maio 2011" "help2man 1.39.3" "Comandos de usuário"
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.39.4.
+.TH HELP2MAN "1" "maio 2011" "help2man 1.39.4" "Comandos de usuário"
 .SH NOME
 help2man \- gera uma página de manual simples
 .SH DESCRIÇÃO
diff --git a/help2man.ru.1 b/help2man.ru.1
index 459a15b..8ee9921 100644
--- a/help2man.ru.1
+++ b/help2man.ru.1
@@ -1,5 +1,5 @@
-.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.39.3.
-.TH HELP2MAN "1" "Май 2011" "help2man 1.39.3" "Пользовательские команды"
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.39.4.
+.TH HELP2MAN "1" "Май 2011" "help2man 1.39.4" "Пользовательские команды"
 .SH ИМЯ
 help2man \- генерирует простую справочную страницу
 .SH ОБЗОР
diff --git a/help2man.sv.1 b/help2man.sv.1
index 96032c8..4d4c4d3 100644
--- a/help2man.sv.1
+++ b/help2man.sv.1
@@ -1,5 +1,5 @@
-.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.39.3.
-.TH HELP2MAN "1" "maj 2011" "help2man 1.39.3" "Användarkommandon"
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.39.4.
+.TH HELP2MAN "1" "maj 2011" "help2man 1.39.4" "Användarkommandon"
 .SH NAMN
 help2man \- generera en enkel manualsida
 .SH BESKRIVNING
diff --git a/help2man.texi b/help2man.texi
index ea30009..540fdc8 100644
--- a/help2man.texi
+++ b/help2man.texi
@@ -78,6 +78,7 @@ and @samp{--version} output of other commands.
 * --help recommendations::      Recommended formatting for --help output.
 * Makefile usage::              Using @command{help2man} with @command{make}.
 * Localised man pages::         Producing native language manual pages.
+* Example::                     Example @command{help2man} output.
 * Reports::                     Reporting bugs or suggestions.
 * Availability::                Obtaining @command{help2man}.
 @end menu
@@ -367,7 +368,7 @@ either of:
 AM_MISSING_PROG(HELP2MAN, help2man, $missing_dir)
 @end example
 
-for @code{automake}, or something like:
+for @command{automake}, or something like:
 
 @example
 AC_PATH_PROG(HELP2MAN, help2man, false // No help2man //)
@@ -429,6 +430,122 @@ This preload has only been tested against @command{eglibc} 2.11.2 and
 does (or doesn't) work for you (@pxref{Reports}).
 @end itemize
 
+@node Example
+@chapter Example @command{help2man} Output
+
+Given a hypothetical program @command{foo} which produces the following output:
+
+@c Default values strong/em to be used in Examples, these are
+@c overridden for info, which doeesn't have real bold/italic.
+@macro exstrong{text}
+@strong{\text\}
+@end macro
+@macro exemph{text}
+@emph{\text\}
+@end macro
+
+@c No-op version for info:
+@ifinfo
+@unmacro exstrong
+@macro exstrong{text}
+\text\
+@end macro
+@unmacro exemph
+@macro exemph{text}
+\text\
+@end macro
+@end ifinfo
+
+@example
+@exstrong{$ foo --version}
+GNU foo 1.1
+
+Copyright (C) 2011 Free Software Foundation, Inc.
+This is free software; see the source for copying conditions.  There is NO
+warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
+
+Written by A. Programmer.
+@exstrong{$ foo --help}
+GNU `foo' does nothing interesting except serve as an example for
+`help2man'.
+
+Usage: foo [OPTION]...
+
+Options:
+  -a, --option      an option
+  -b, --another-option[=VALUE]
+                    another option
+
+      --help        display this help and exit
+      --version     output version information and exit
+
+Examples:
+  foo               do nothing
+  foo --option      the same thing, giving `--option'
+
+Report bugs to <bug-gnu-utils@@gnu.org>.
+@end example
+
+@command{help2man} will produce @command{nroff} input for a manual
+page which will be formatted something like this:
+
+@example
+FOO(1)                         User Commands                        FOO(1)
+
+
+@exstrong{NAME}
+       foo - manual page for foo 1.1
+
+@exstrong{SYNOPSIS}
+       foo [OPTION]...
+
+@exstrong{DESCRIPTION}
+       GNU  `foo'  does nothing interesting except serve as an example for
+       `help2man'.
+
+@exstrong{OPTIONS}
+       @exstrong{-a}, @exstrong{--option}
+              an option
+
+       @exstrong{-b}, @exstrong{--another-option}[=@exemph{VALUE}]
+              another option
+
+       @exstrong{--help} display this help and exit
+
+       @exstrong{--version}
+              output version information and exit
+
+@exstrong{EXAMPLES}
+       foo    do nothing
+
+       foo @exstrong{--option}
+              the same thing, giving `--option'
+
+@exstrong{AUTHOR}
+       Written by A. Programmer.
+
+@exstrong{REPORTING BUGS}
+       Report bugs to <bug-gnu-utils@@gnu.org>.
+
+@exstrong{COPYRIGHT}
+       Copyright @copyright{} 2011 Free Software Foundation, Inc.
+       This is free software;  see  the  source  for  copying  conditions.
+       There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A
+       PARTICULAR PURPOSE.
+
+@exstrong{SEE ALSO}
+       The full documentation for @exstrong{foo} is maintained as a  Texinfo  manual.
+       If  the  @exstrong{info} and @exstrong{foo} programs are properly installed at your site,
+       the command
+
+              @exstrong{info foo}
+
+       should give you access to the complete manual.
+
+
+foo 1.1                          May 2011                           FOO(1)
+@end example
+
 @node Reports
 @chapter Reporting Bugs or Suggestions
 
diff --git a/help2man.uk.1 b/help2man.uk.1
index 37d5cac..b6079e8 100644
--- a/help2man.uk.1
+++ b/help2man.uk.1
@@ -1,5 +1,5 @@
-.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.39.3.
-.TH HELP2MAN "1" "травень 2011" "help2man 1.39.3" "Команди користувача"
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.39.4.
+.TH HELP2MAN "1" "травень 2011" "help2man 1.39.4" "Команди користувача"
 .SH НАЗВА
 help2man \— програма для створення простих сторінок довідника
 .SH "КОРОТКИЙ ОПИС"
diff --git a/help2man.vi.1 b/help2man.vi.1
index 0c5543b..1c9c763 100644
--- a/help2man.vi.1
+++ b/help2man.vi.1
@@ -1,5 +1,5 @@
-.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.39.3.
-.TH HELP2MAN "1" "Tháng năm 2011" "help2man 1.39.3" "Lệnh người dùng"
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.39.4.
+.TH HELP2MAN "1" "Tháng năm 2011" "help2man 1.39.4" "Lệnh người dùng"
 .SH TÊN
 help2man \- tạo một trang hướng dẫn đơn giản
 .SH "MÔ TẢ"
diff --git a/po/it.gmo b/po/it.gmo
index d95333c..19ace93 100644
Binary files a/po/it.gmo and b/po/it.gmo differ
diff --git a/po/it.po b/po/it.po
index 50431a3..57ca0f9 100644
--- a/po/it.po
+++ b/po/it.po
@@ -1,14 +1,14 @@
 # Italian translation for help2man.
 # Copyright (C) 2010 Free Software Foundation, Inc.
 # This file is distributed under the same license as the help2man package.
-# Sergio Zanchetta <primes2h@ubuntu.com>, 2010.
+# Sergio Zanchetta <primes2h@ubuntu.com>, 2010, 2011.
 #
 msgid ""
 msgstr ""
-"Project-Id-Version: help2man-1.38.2\n"
+"Project-Id-Version: help2man-1.39.1\n"
 "Report-Msgid-Bugs-To: Brendan O'Dea <bug-help2man@gnu.org>\n"
 "POT-Creation-Date: 2011-02-28 11:20+1100\n"
-"PO-Revision-Date: 2010-11-25 23:19+0100\n"
+"PO-Revision-Date: 2011-05-05 00:15+0200\n"
 "Last-Translator: Sergio Zanchetta <primes2h@ubuntu.com>\n"
 "Language-Team: Italian <tp@lists.linux.it>\n"
 "Language: it\n"
@@ -18,12 +18,11 @@ msgstr ""
 "Plural-Forms: nplurals=2; plural= (n != 1)\n"
 
 #: help2man:69
-#, fuzzy, perl-format
+#, perl-format
 msgid ""
 "GNU %s %s\n"
 "\n"
-"Copyright (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2009, "
-"2010,\n"
+"Copyright (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2009, 2010,\n"
 "2011 Free Software Foundation, Inc.\n"
 "This is free software; see the source for copying conditions.  There is NO\n"
 "warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.\n"
@@ -32,9 +31,8 @@ msgid ""
 msgstr ""
 "GNU %s %s\n"
 "\n"
-"Copyright (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2009, "
-"2010\n"
-"Free Software Foundation, Inc.\n"
+"Copyright (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2009, 2010,\n"
+"2011 Free Software Foundation, Inc.\n"
 "Questo è software libero; si vedano i sorgenti per le condizioni di copia.\n"
 "NON c'è alcuna garanzia; neppure di COMMERCIABILITÀ o di IDONEITÀ A UNO\n"
 "SCOPO PARTICOLARE.\n"
@@ -42,7 +40,7 @@ msgstr ""
 "Scritto da Brendan O'Dea <bod@debian.org>\n"
 
 #: help2man:80
-#, fuzzy, perl-format
+#, perl-format
 msgid ""
 "`%s' generates a man page out of `--help' and `--version' output.\n"
 "\n"
@@ -62,8 +60,7 @@ msgid ""
 "     --help              print this help, then exit\n"
 "     --version           print version number, then exit\n"
 "\n"
-"EXECUTABLE should accept `--help' and `--version' options and produce output "
-"on\n"
+"EXECUTABLE should accept `--help' and `--version' options and produce output on\n"
 "stdout although alternatives may be specified using:\n"
 "\n"
 " -h, --help-option=STRING     help option string\n"
@@ -78,30 +75,26 @@ msgstr ""
 "Uso: %s [OPZIONE]... ESEGUIBILE\n"
 "\n"
 " -n, --name=STRINGA      Descrizione per il paragrafo NOME\n"
-" -s, --section=SEZIONE   Numero di sezione per la pagina di manuale (1, 6, "
-"8)\n"
+" -s, --section=SEZIONE   Numero di sezione per la pagina di manuale (1, 6, 8)\n"
 " -m, --manual=TESTO      Nome del manuale (Comandi utente, ...)\n"
 " -S, --source=TESTO      Provenienza del programma (FSF, Debian, ...)\n"
 " -L, --locale=STRINGA    Seleziona la localizzazione (predefinita \"C\")\n"
 " -i, --include=FILE      Include il materiale proveniente dal \"FILE\"\n"
-" -I, --opt-include=FILE  Include il materiale proveniente dal \"FILE\" se "
-"esiste\n"
+" -I, --opt-include=FILE  Include il materiale proveniente dal \"FILE\" se esiste\n"
 " -o, --output=FILE       Invia l'output su \"FILE\"\n"
 " -p, --info-page=TESTO   Nome del manuale Texinfo\n"
 " -N, --no-info           Elimina il riferimento al manuale Texinfo\n"
+" -l, --libtool           Esclude \"lt-\" dal nome del programma\n"
 "     --help              Stampa questo aiuto ed esce\n"
 "     --version           Stampa il numero di versione ed esce\n"
 "\n"
-"L'ESEGUIBILE dovrebbe accettare le opzioni \"--help\" e \"--version\" e "
-"produrre output su\n"
+"L'ESEGUIBILE dovrebbe accettare le opzioni \"--help\" e \"--version\" e produrre output su\n"
 "stdout sebbene le alternative possano essere specificate usando:\n"
 "\n"
 " -h, --help-option=STRINGA     Stringa con opzione alternativa per l'aiuto\n"
-" -v, --version-option=STRINGA  Stringa con opzione alternativa per la "
-"versione\n"
+" -v, --version-option=STRINGA  Stringa con opzione alternativa per la versione\n"
 " --version-string=STRINGA      Stringa della versione\n"
-" --no-discard-stderr           Include lo stderr nell'analisi dell'output "
-"dell'opzione\n"
+" --no-discard-stderr           Include lo stderr nell'analisi dell'output dell'opzione\n"
 "\n"
 "Segnalare i bug a <bug-help2man@gnu.org>.\n"
 
@@ -306,12 +299,11 @@ msgid ""
 "    /pattern/\n"
 "    text\n"
 msgstr ""
-"Nell'output generato possono essere inclusi materiali aggiuntivi con le "
-"opzioni\n"
+"Nell'output generato possono essere inclusi materiali aggiuntivi con le opzioni\n"
 ".B \\-\\-include\n"
 "e\n"
-".BR \\-\\-opt\\-include .\n"
-"Il formato è semplice:\n"
+".B \\-\\-opt\\-include\n"
+".  Il formato è semplice:\n"
 "\n"
 "    [sezione]\n"
 "    testo\n"
@@ -345,8 +337,7 @@ msgid ""
 "modifiers (see\n"
 ".BR perlre (1)).\n"
 msgstr ""
-"I modelli usano la sintassi delle espressioni regolari Perl e possono essere "
-"seguiti dai\n"
+"I modelli usano la sintassi delle espressioni regolari Perl e possono essere seguiti dai\n"
 "modificatori\n"
 ".IR i ,\n"
 ".I s\n"
@@ -361,10 +352,8 @@ msgid ""
 "processed as options.  Anything else is silently ignored and may be\n"
 "used for comments, RCS keywords and the like.\n"
 msgstr ""
-"Le righe precedenti la prima sezione o i modelli che iniziano con \"\\-\" "
-"sono\n"
-"elaborati come opzioni.  Qualsiasi altra cosa è ignorata in silenzio e può "
-"essere\n"
+"Le righe precedenti la prima sezione o i modelli che iniziano con \"\\-\" sono\n"
+"elaborati come opzioni.  Qualsiasi altra cosa è ignorata in silenzio e può essere\n"
 "usata per commenti, parole chiave RCS e simili.\n"
 
 #: help2man.h2m.PL:127
@@ -404,8 +393,7 @@ msgid ""
 ".I other\n"
 "(above) in the order they were encountered in the include file.\n"
 msgstr ""
-"Altre sezioni sono inserite prima di quelle automaticamente prodotte in "
-"output\n"
+"Altre sezioni sono inserite prima di quelle automaticamente prodotte in output\n"
 "per le sezioni standard fornite precedentemente, oppure sono incluse in\n"
 ".I altre\n"
 "(come sopra) nell'ordine riscontrato nel file di inclusione.\n"