[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Bug#630022: marked as done (Typedefs in manpages has too few linebreak possiblilities)

Your message dated Tue, 17 Apr 2018 17:49:35 +0200
with message-id <3f711a22-c60b-f5bd-4b7d-5b18d217eacc@libpf.com>
and subject line resolved
has caused the Debian Bug report #630022,
regarding Typedefs in manpages has too few linebreak possiblilities
to be marked as done.

This means that you claim that the problem has been dealt with.
If this is not the case it is now your responsibility to reopen the
Bug report if necessary, and/or fix the problem forthwith.

(NB: If you are a system administrator and have no idea what this
message is talking about, this may indicate a serious mail system
misconfiguration somewhere. Please contact owner@bugs.debian.org
immediately.)


-- 
630022: https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=630022
Debian Bug Tracking System
Contact owner@bugs.debian.org with problems
--- Begin Message --- 
Package: doxygen
Version: 1.7.4-2
Severity: normal

The following markup:

/**
 * @defgroup mytypes My types
 * @{
 */

/**
 * This typedef will become a very long line in the man page that can not be
 * broken properly.
 */
typedef void(*myTypes_Function_Type_With_A_Long_Name)
(myTypes_Other_Type_With_A_Long_Name *first, void *second);
/**
 * @}
 */

Generates a manpage that contains the line:

.SS "typedef void(* \fBmyTypes_Function_Type_With_A_Long_Name\fP)(myTypes_Other_Type_With_A_Long_Name *first, void *second)"This typedef will become a very long line in the man page that can not be broken properly. 

When displayed using man this will not fit on a standard 80 column
screen

It is not a very common problem, but it happens often enough that it is
annoying.

A better display would be achieved if there was a space between
the )( in the man page output:

.SS "typedef void(* \fBmyTypes_Function_Type_With_A_Long_Name\fP) (myTypes_Other_Type_With_A_Long_Name *first, void *second)"This typedef will become a very long line in the man page that can not be broken properly. 

I think this would be easier to read also for the types that do fit on
one line.

This issue causes many manpage-has-errors-from-man (can't break line)
warnings from lintian.

Attachment: smime.p7s
Description: S/MIME cryptographic signature


--- End Message ---
--- Begin Message --- 
Version: 1.8.9.1-1

I checked and the issue is indeed solved in Debian.

Paolo

--- End Message ---
Reply to: