https://bugs.wireshark.org/bugzilla/show_bug.cgi?id=16658
--- Comment #3 from Sunil <b18...@students.iitmandi.ac.in> ---
(In reply to Guy Harris from comment #2)
> That shows only the authors list; are there other parts with issues?
Sorry, but I could add only one attachment there. I read all the man page and
found few issues as per me which could be improved. Some of them are here:
<https://www.notion.so/Some-issues-in-Wireshark-s-man-page-c5673c8daa504464a25a8777350da38f>
> The XXXX is a result of, I suspect, pod2man converting the "Дмитрий Цветцих"
> in the generated wireshark.pod file into a bunch of Xes.
>
> It turns the é in Eduardo Pérez Ureta's name to e\*'. Unfortunately, the
> version of groff on my machine:
>
> $ groff --version
> GNU groff version 1.19.2
> Copyright (C) 2004 Free Software Foundation, Inc.
> GNU groff comes with ABSOLUTELY NO WARRANTY.
> You may redistribute copies of groff and its subprograms
> under the terms of the GNU General Public License.
> For more information about these matters, see the file named COPYING.
>
> called subprograms:
>
> GNU troff (groff) version 1.19.2
> GNU grops (groff) version 1.19.2
>
> just renders that as an un-accented e, but it's not as bad as turning all
> Cyrillic text into X's.
Thanks for the reply. I've only worked with pod2man as of now. But I'll check
the same with groff too.
> It may be that there is no way to guarantee that arbitrary non-ASCII
> characters can be formatted by arbitrary man page formatters (at a minimum,
> it needs to deal with groff and mandoc; on traditional AT&T-derived UNIXes
> they might still be using ditroff or even traditional nroff), in which case
> that might be a difficult problem to solve by any means other than limiting
> the characters allowed in the AUTHORS file, e.g. require Romanization of
> names.
In such case, can we use usernames instead of names which are formatted
wrongly? As we already are using usernames too. 'dmistrycvet' looks better than
a bunch of X's.
Another small issue which can be seen in the screenshot sent by me is few
names(like Eric Piel) are placed below usernames, which should be placed above.
I don't know how this went wrong. Could this be because those names were added
late? May be. But they can be placed at correct place now.
> The spacing issues *might* be due to the man page formatter in question not
> making as much of an effort as possible to preserve spacing.
I am setting up the tools locally. If the spacing works out well, I'll notify
you here.
--
You are receiving this mail because:
You are watching all bug changes.
___________________________________________________________________________
Sent via: Wireshark-bugs mailing list <wireshark-bugs@wireshark.org>
Archives: https://www.wireshark.org/lists/wireshark-bugs
Unsubscribe: https://www.wireshark.org/mailman/options/wireshark-bugs
mailto:wireshark-bugs-requ...@wireshark.org?subject=unsubscribe
