Bug 25262 - woman can't show some manpages (e.g., git)
Summary: woman can't show some manpages (e.g., git)
Alias: None
Product: Branch p7
Classification: Distributions
Component: emacs24-common (show other bugs)
Version: не указана
Hardware: all Linux
: P3 normal
Assignee: Andrey Cherepanov
QA Contact: qa-p7@altlinux.org
Depends on:
Reported: 2011-03-20 21:28 MSK by Ivan Zakharyaschev
Modified: 2015-03-19 14:49 MSK (History)
0 users

See Also:


Note You need to log in before you can comment on or make changes to this bug.
Description Ivan Zakharyaschev 2011-03-20 21:28:06 MSK

If I try to view Git's manpages (git-core- with woman (say, M-x woman git or M-x woman git-config), woman isn't able to process them as manpages (it shows the source).

Expected: it accepts Git's manpages and shows them correctly, as it does, say, for the "prctl" manpage (I just selected this one as a test example).
Comment 1 Ivan Zakharyaschev 2011-03-20 21:32:52 MSK
The output in the *WoMan-Log* buffer for the "bad" manpage:

Formatting file /usr/share/man/man1/git.1.bz2 at Sun Mar 20 19:06:07 2011
  **  Numeric/register argument error: n[.$] \&$*
  **  de1 SH  request ignored!
  **  Numeric/register argument error: n[PD]u
  **  set-an-margin  request ignored!
  **  Numeric/register argument error: n[IN]
  **  Numeric/register argument error: n[an-margin]u
  **  HTML-TAG ".NH n[an-level]"  request ignored!
  **  it 1 an-trap  request ignored!
  **  " make the size of the head bigger  request ignored!
  **  .  request ignored!
  **  de1 SS  request ignored!

I should have said also that man-1.6f-alt11 renders these Git's manpages well, unlike woman.
Comment 2 Michael Shigorin 2014-11-05 20:43:27 MSK
В 4.1/branch исправления не будут вноситься уже технически (заглушена очередь на сборку), поэтому прошу ошибки, актуальные для sisyphus/p7/t7, перевесить на текущие ветки или сизиф.
Comment 3 Ivan Zakharyaschev 2015-02-23 16:21:54 MSK

The result is much better, but there is some garbage in the "git" man-page:


	Git is a fast, scalable, distributed revision control system
	with an unusually rich command set that provides both
	high-level operations and full access to internals.

	See gittutorial(7) to get started, then see \m[blue]Everyday
	Git\m[]^[1] for a useful minimum set of commands. The
	\m[blue]Git User’s Manual\m[]^[2] has a more in-depth
Comment 4 Ivan Zakharyaschev 2015-02-24 23:37:07 MSK
Another man-page with problems for woman comes from:

$ rpm -qf "$(which top)"

The bad rendering:

\#  Setup ////////////////////////////////////////////////////////////////
\#  ** Comment out '.nr' or set to 0 to eliminate WIDTH fiddlin' !
\#  **  we use single  quote char (') a  lot, so change  the no-break
ctrl char
\#                            Our      own       Bullet      style(s)
--------------------------   \#                       Commonly   used
strings (for  consistency) ----------  \#                           -
our em-dashes \#                           -  our program name (makes
great  grammar) \#                            - other  misc strs  for
consistent  usage \#                            - Note:  our 'Command
Line' used in 2 places  \#                           ( and managed to
fit in an  80x24 terminal ) \#                       Reference to the
various widths/sizes ------------  \#                           - the
max  screen width  limit  \#                            - the  header
width  w/ all  fields \#                            - pid  monitoring
limit  \#                      Xref's  that  depend on/mention  other
stuff --------
TOP(1) -- March 2013 -- procps-ng -- User Commands

	top - display Linux processes

	top  -hv|-bcHiOSs -d  secs -n  max -u|U  user -p  pid -o  fld -w

	The traditional switches '-' and whitespace are optional.
Comment 5 Ivan Zakharyaschev 2015-03-19 14:49:07 MSK
Another man-page with problems:

$ rpm -qf /usr/share/man/man1/netcat.1.gz

Result looks like this:

.Dd $Mdocdate: July 25 2010 $
.Dt NC 1
.Nm nc
.Nd arbitrary TCP and UDP connections and listens
.Nm nc
.Bk -words
.Op Fl 46DdhklnrStUuvz
.Op Fl e Ar command
.Op Fl I Ar length
.Op Fl i Ar interval
.Op Fl O Ar length
.Oo Xo
.Fl P Ar proxy_username Ns Oo : Ns
.Ar proxy_password Oc Oc
.Op Fl p Ar source_port
.Op Fl s Ar source_ip_address
.Op Fl T Ar ToS
.Op Fl V Ar rtable
.Op Fl w Ar timeout
.Op Fl X Ar proxy_protocol
.Oo Xo
.Fl x Ar proxy_address Ns Oo : Ns
.Ar port Oc
.Xc Oc
.Op Ar hostname
.Op Ar port
.Nm netcat )
utility is used for just about anything under the sun involving TCP