https://bugs.wireshark.org/bugzilla/show_bug.cgi?id=16658
--- Comment #9 from Sunil <b18...@students.iitmandi.ac.in> ---
(In reply to Guy Harris from comment #4)
> groff isn't an alternative to pod2man. pod2man converts pod (Plain Old
> Documentation) files to man page files; groff formats text, including (but
> not limited to) man page text (it's the GNU implementation of the
> traditional UN*X nroff/troff).
>
> There's also mandoc:
>
> https://mandoc.bsd.lv
>
> which formats man page files. It's not as general as groff, which can be
> given a set of *roff macro definitions to use to format files, with -man and
> -mdoc being two of the macro packages that can be used; mandoc only knows
> how to format -man and -mdoc documents.
Thanks for the clearance. I'll read more.
> Usernames are subject to change over time; I've used both "guy" and
> "gharris" at various times. A person might have different usernames on
> different systems, too.
>
> Names can change as well, but that's probably less likely to happen. The
> main reason for name changes is probably marriage, if somebody takes their
> spouse's family name.
>
> We could, I guess, use *only* the email address, but it seems a bit more
> polite to give a name if possible. A user might be better known by their
> name than by their email address.
>
> > instead of names which are formatted
> > wrongly? As we already are using usernames too. 'dmistrycvet' looks better
> > than a bunch of X's.
> And a Romanization, such as "Dmitry Tsvettsikh", might be better than either
> of them. Unfortunately, if the Wikipedia is to be believed:
>
> https://en.wikipedia.org/wiki/Romanization_of_Cyrillic
>
> there isn't a single standard for the Romanization of Cyrillic, and there
> doesn't even appear to be a single standard for the Romanization of, for
> example, Russian:
>
> https://en.wikipedia.org/wiki/Romanization_of_Russian
>
> The one I gave is the Google Translate Romanization, produced by pasting
> "Дмитрий Цветцих" into the "from" box on Google Translate and translating to
> English.
I thought we're using the usernames only pertaining to the bugzilla(which
*perhaps* does not does not allow change in username. I read
here<http://sqa.fyicenter.com/FAQ/Bugzilla/How_do_I_change_my_user_name_in_Bugzilla_.html>)
> > Another small issue which can be seen in the screenshot sent by me is few
> > names(like Eric Piel) are placed below usernames,
>
> In the screenshot you attached, "Eric Piel" is to the left of
> "<piel[AT]delmic.com>"; it's not below it, it's on the same line.
>
> (By "usernames" you presumably mean "email addresses".)
>
> > which should be placed above.
>
> It shouldn't be below or above "<piel[AT]delmic.com>", it should be on the
> same line as "<piel[AT]delmic.com>".
>
> It's not aligned *horizontally* with other email addresses, but that's what
> I assumed you were referring to when you said "incorrect spacing".
Yeah. I know they are meant to be aligned horizontally. I meant that one entry
(i.e. a Full Name and corresponding email ID) is placed wrongly. The name and
email ID are correctly placed with respect to each other(horizontally). Please
check my new screenshot which might clear your doubt.
> > I don't know how this went wrong. Could this be because those names
> > were added late?
>
> No, it couldn't. The order in which names are added affects the *vertical*
> placement of the lines containing the name and email address; it doesn't
> affect how the email address column is lined up.
>
> It probably went wrong for the reason I gave, namely that "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."
>
> > May be. But they can be placed at correct place now.
>
> What's the "correct place"? If you mean that the names aren't in
> alphabetical order, that's true, but that's because we have not decided to
> *put* them in alphabetical order.
Yeah. Not all the AUTHORS section is in alphabetical order but, the *FROM GIT
LOG* portion of it is in alphabetical order. And my old screenshot is of that
portion only. So, only those two entries are wrongly placed as their full names
(Emilio Gonzalez and Eric Piel) is known and their email
IDs(piel[AT]delmic.com> and <egg997[AT]gmail.com>) are known. So, they could be
placed at right place(in alphabetical order).
--
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
