Hey Pablo,
On Sat, Jul 16, 2016 at 10:03:53PM +0800, Paul Wise wrote:
> Package: gdb-doc
> Version: 7.11.1-1
> Severity: normal
> File: /usr/share/man/man1/gdb.1.gz
>
> The manual page is missing documentation of the -tui option:
>
> https://sourceware.org/gdb/onlinedocs/gdb/TUI.html
Some time ago, there was a patch for such purpose (man-page-args.patch)
This was coming from similar request to this one:
https://bugs.debian.org/362795
However manpage was rewriten as texinfo document and licensed under GFDL 1.3
I was pondering if we should be able to modify the text and document the
feature in the manpage, however I understand from license requirements:
"
Copyright @copyright{} 1988-2016 Free Software Foundation, Inc.
Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.3 or
any later version published by the Free Software Foundation; with the
Invariant Sections being ``Free Software'' and ``Free Software Needs
Free Documentation'', with the Front-Cover Texts being ``A GNU Manual,''
and with the Back-Cover Texts as in (a) below.
(a) The FSF's Back-Cover Text is: ``You are free to copy and modify
this GNU Manual. Buying copies from GNU Press supports the FSF in
developing GNU and promoting software freedom.''
"
Does the manual page have covers to modify?
GFDL 4A:
"
A. Use in the Title Page (and on the covers, if any) a title distinct
from that of the Document, and from those of previous versions
(which should, if there were any, be listed in the History section
of the Document). You may use the same title as a previous version
if the original publisher of that version gives permission.
"
To accomplish that I understand that we need to modify the manpage title
page, which is the program name.
Also in Debian package changelog you might find the following comment:
"
- Drop man-page-args.patch and man-page-order.patch:
Manpages are dead to us now (not DFSG free), and the source is in
texinfo now anyway.
"
Given all the above I tend to think that we should propose upstream to
document such option in the manpage instead of us modifying it.
In anycase, you should be able to access TUI pages and know about it by
checking:
info gdb
or
file:///usr/share/doc/gdb-doc/html/gdb/TUI.html
Regards,
--
Hector Oron
signature.asc
Description: PGP signature