Bug#842247: astyle: OPTIONS is missing ffrom manual page

2016-10-27 Thread Matteo Cypriani
Control: tag -1 wontfix

Hi Jari,

Le jeudi 27 octobre 2016 14:25:05 EDT, Jari Aalto a écrit :
> Please make the manual page complete without the need to consult
> external sources.

We have maintained a complete manpage in the Debian package for years. Each 
new version of astyle implied updating it manually from the HTML 
documentation, usually with a fair amount of changes. This was nice for users, 
but was just too much work. The current manpage points to the HTML 
documentation, which is obviously a compromise.

If you think a complete manpage is important (and I agree it is), you should 
contact the astyle authors and maybe propose them a system to write the 
astyle.html in a source language like DocBook, txt2tags, or whatever is to 
your and their liking, that could then be converted automatically to both html 
and roff.

Please let us know if you do get in touch with upstream.

Cheers,
  Matteo

signature.asc
Description: This is a digitally signed message part.


Bug#842247: astyle: OPTIONS is missing ffrom manual page

2016-10-27 Thread Jari Aalto
Package: astyle
Version: 2.04-1.1
Severity: minor

Program syntax refers to options, but they are not listed in manual
page:

  NAME
   astyle - multi-language indentation and reformatting filters

  SYNOPSIS
   astyle

   astyle [options] File1 [File2] [...]


Please make the manual page complete without the need to consult
external sources.

-- System Information:
Debian Release: stretch/sid
  APT prefers testing
  APT policy: (990, 'testing'), (500, 'unstable')
Architecture: amd64 (x86_64)

Kernel: Linux 3.2.0-4-amd64 (SMP w/2 CPU cores)
Locale: LANG=en_US.UTF-8, LC_CTYPE=en_US.UTF-8 (charmap=UTF-8)
Shell: /bin/sh linked to /bin/dash
Init: systemd (via /run/systemd/system)

Versions of packages astyle depends on:
ii  libc6   2.24-3
ii  libstdc++6  6.2.0-6

astyle recommends no packages.

astyle suggests no packages.

-- no debconf information