[Bug libstdc++/42460] man page errors for generated libstdc++ man pages
--- Comment #25 from rguenth at gcc dot gnu dot org 2010-04-06 11:20 --- GCC 4.5.0 is being released. Deferring to 4.5.1. -- rguenth at gcc dot gnu dot org changed: What|Removed |Added Target Milestone|4.5.0 |4.5.1 http://gcc.gnu.org/bugzilla/show_bug.cgi?id=42460
[Bug libstdc++/42460] man page errors for generated libstdc++ man pages
--- Comment #26 from paolo dot carlini at oracle dot com 2010-04-06 11:22 --- Let's just close it as fixed. -- paolo dot carlini at oracle dot com changed: What|Removed |Added Status|ASSIGNED|RESOLVED Resolution||FIXED Target Milestone|4.5.1 |4.5.0 http://gcc.gnu.org/bugzilla/show_bug.cgi?id=42460
[Bug libstdc++/42460] man page errors for generated libstdc++ man pages
--- Comment #24 from debian-gcc at lists dot debian dot org 2010-02-23 01:37 --- thanks for the fixes. I don't care that much about the function markups. Matthias -- http://gcc.gnu.org/bugzilla/show_bug.cgi?id=42460
[Bug libstdc++/42460] man page errors for generated libstdc++ man pages
--- Comment #23 from bkoz at redhat dot com 2010-02-18 19:09 --- Subject: Re: man page errors for generated libstdc++ man pages 2010-02-17 09:36 --- So... shall we close this as fixed? Remaining item is doxygen function markup is not working for man pages. But this is an upstream (doxygen) doxygen, and this closed. I do not see any other thing to do from a libstdc++ POV. Original reporter calls? -benjamin -- http://gcc.gnu.org/bugzilla/show_bug.cgi?id=42460
[Bug libstdc++/42460] man page errors for generated libstdc++ man pages
--- Comment #22 from paolo dot carlini at oracle dot com 2010-02-17 09:36 --- So... shall we close this as fixed? -- http://gcc.gnu.org/bugzilla/show_bug.cgi?id=42460
[Bug libstdc++/42460] man page errors for generated libstdc++ man pages
--- Comment #21 from bkoz at gcc dot gnu dot org 2010-02-09 04:50 --- Subject: Bug 42460 Author: bkoz Date: Tue Feb 9 04:49:49 2010 New Revision: 156617 URL: http://gcc.gnu.org/viewcvs?root=gccview=revrev=156617 Log: 2010-02-08 Benjamin Kosnik b...@redhat.com PR libstdc++/42460 * include/tr1_impl/regex: Fix quoting issues in doxygen markup. * include/bits/random.h: Fix multi-line doxygen function markup. 2010-02-08 Matthias Klose d...@debian.org PR libstdc++/42460 * include/std/istream: Fix '\' quoting in doxygen markup. Modified: trunk/libstdc++-v3/ChangeLog trunk/libstdc++-v3/include/bits/random.h trunk/libstdc++-v3/include/std/istream trunk/libstdc++-v3/include/tr1_impl/regex -- http://gcc.gnu.org/bugzilla/show_bug.cgi?id=42460
[Bug libstdc++/42460] man page errors for generated libstdc++ man pages
--- Comment #16 from bkoz at gcc dot gnu dot org 2010-02-04 18:20 --- Subject: Bug 42460 Author: bkoz Date: Thu Feb 4 18:20:34 2010 New Revision: 156502 URL: http://gcc.gnu.org/viewcvs?root=gccview=revrev=156502 Log: 2010-02-04 Benjamin Kosnik b...@redhat.com PR libstdc++/42460 * doc/doxygen/user.cfg.in: Update file list. * include/debug/safe_sequence.h: Doxygen markup fixes for '' and . * include/debug/safe_base.h: Same. * include/debug/macros.h: Same. * include/tr1_impl/regex: Same. * include/std/iostream: Same. * include/std/streambuf: Same. * include/std/bitset: Same. * include/std/iosfwd: Same. * include/std/limits: Same. * include/std/fstream: Same. * include/std/istream: Same. * include/std/ostream: Same. * include/std/sstream: Same. * include/parallel/multiway_merge.h: Same. * include/parallel/for_each.h: Same. * include/parallel/workstealing.h: Same. * include/parallel/omp_loop_static.h: Same. * include/parallel/omp_loop.h: Same. * include/c_std/csignal: Same. * include/c_std/cstdlib: Same. * include/c_std/cstdio: Same. * include/c_std/cstdarg: Same. * include/c_std/cctype: Same. * include/c_std/cerrno: Same. * include/c_std/cmath: Same. * include/c_std/ciso646: Same. * include/c_std/ctime: Same. * include/c_std/clocale: Same. * include/c_std/climits: Same. * include/c_std/cassert: Same. * include/c_std/csetjmp: Same. * include/c_std/cwchar: Same. * include/c_std/cfloat: Same. * include/c_std/cstring: Same. * include/c_std/cstddef: Same. * include/c_std/cwctype: Same. * include/profile/iterator_tracker.h: Same. * include/profile/impl/profiler_trace.h: Same. * include/ext/vstring.h: Same. * include/ext/algorithm: Same. * include/ext/pb_ds/detail/pat_trie_/pat_trie_.h.pp: Same. * include/ext/pb_ds/detail/bin_search_tree_/bin_search_tree_.h.pp: Same. * include/ext/pb_ds/detail/type_utils.hpp: Same. * include/ext/pb_ds/detail/splay_tree_/splay_tree_.hpp: Same * include/ext/pb_ds/detail/rb_tree_map_/rb_tree_.hpp: Same. * include/ext/rc_string_base.h: Same. * include/ext/stdio_sync_filebuf.h: Same. * include/ext/functional: Same. * include/ext/mt_allocator.h: Same. * include/bits/basic_ios.h: Same. * include/bits/stl_map.h: Same. * include/bits/stl_algobase.h: Same. * include/bits/stl_queue.h: Same. * include/bits/locale_classes.h: Same. * include/bits/stl_set.h: Same. * include/bits/locale_facets.h: Same. * include/bits/stl_stack.h: Same. * include/bits/stl_iterator_base_types.h: Same. * include/bits/basic_string.h: Same. * include/bits/stl_multimap.h: Same. * include/bits/ios_base.h: Same. * include/bits/stl_deque.h: Same. * include/bits/stl_multiset.h: Same. * include/bits/stl_iterator_base_funcs.h: Same. * include/bits/char_traits.h: Same. * include/bits/stl_algo.h: Same. * include/bits/stl_iterator.h: Same. * include/bits/stl_tempbuf.h: Same. * include/bits/random.tcc: Same. * include/bits/stl_function.h: Same. * include/bits/cpp_type_traits.h: Same. * include/bits/random.h: Same. * include/bits/allocator.h: Same. * include/bits/locale_facets_nonio.h: Same. * include/c_global/csignal: Same. * include/c_global/cstdlib: Same. * include/c_global/cstdio: Same. * include/c_global/cstdarg: Same. * include/c_global/cctype: Same. * include/c_global/cerrno: Same. * include/c_global/cmath: Same. * include/c_global/ciso646: Same. * include/c_global/ctime: Same. * include/c_global/clocale: Same. * include/c_global/climits: Same. * include/c_global/cassert: Same. * include/c_global/csetjmp: Same. * include/c_global/cwchar: Same. * include/c_global/cfloat: Same. * include/c_global/cstring: Same. * include/c_global/cstddef: Same. * include/c_global/cwctype: Same. * include/tr1/hypergeometric.tcc: Same. * include/tr1/random.tcc: Same. * include/tr1/functional: Same. * include/tr1/random.h: Same. * include/backward/auto_ptr.h: Same. * include/backward/binders.h: Same. * testsuite/23_containers/deque/requirements/dr438/assign_neg.cc: Adjust line numbers. * testsuite/23_containers/deque/requirements/dr438/insert_neg.cc: Same. * testsuite/23_containers/deque/requirements/dr438/constructor_1_neg.cc: Same. *
[Bug libstdc++/42460] man page errors for generated libstdc++ man pages
--- Comment #17 from bkoz at gcc dot gnu dot org 2010-02-04 18:27 --- Hey. Can you re-check trunk now? I should have most of the quoting issues fixed. I've uploaded man pages with the new markup here: ftp://gcc.gnu.org/pub/libstdc++/doxygen/libstdc++-man.20100204.tar.bz2 Can you check these (or equivalent from trunk) please? -- http://gcc.gnu.org/bugzilla/show_bug.cgi?id=42460
[Bug libstdc++/42460] man page errors for generated libstdc++ man pages
-- bkoz at gcc dot gnu dot org changed: What|Removed |Added AssignedTo|unassigned at gcc dot gnu |bkoz at gcc dot gnu dot org |dot org | Status|REOPENED|ASSIGNED Last reconfirmed|2010-01-07 18:40:02 |2010-02-04 18:28:04 date|| http://gcc.gnu.org/bugzilla/show_bug.cgi?id=42460
[Bug libstdc++/42460] man page errors for generated libstdc++ man pages
--- Comment #18 from debian-gcc at lists dot debian dot org 2010-02-04 18:39 --- this is a check run by the lintian tool to check .deb packages after they are built. for this check, lintian calls 'man --warnings -E UTF-8 -l file' for every generated manpage. Afaik Debian/Ubuntu do use another man implementation than Fedora, so I don't know if this option is available there as well. -- http://gcc.gnu.org/bugzilla/show_bug.cgi?id=42460
[Bug libstdc++/42460] man page errors for generated libstdc++ man pages
--- Comment #19 from debian-gcc at lists dot debian dot org 2010-02-04
21:00 ---
std::basic_fstream.3cxx.gz 1213: warning: macro `)).' not defined
std::basic_ifstream.3cxx.gz 1037: warning: macro `)).' not defined
std::basic_iostream.3cxx.gz 1172: warning: macro `)).' not defined
std::basic_istream.3cxx.gz 1002: warning: macro `)).' not defined
std::basic_istringstream.3cxx.gz 1025: warning: macro `)).' not defined
std::basic_stringstream.3cxx.gz 1202: warning: macro `)).' not defined
std::exponential_distribution.3cxx.gz 66: warning: numeric expression expected
(got `m')
std::gamma_distribution.3cxx.gz 79: normal or special character expected (got a
space)
std::linear_congruential_engine.3cxx.gz 82: warning: numeric expression
expected (got `f')
std::lognormal_distribution.3cxx.gz 79: warning: numeric expression expected
(got `r')
std::normal_distribution.3cxx.gz 79: warning: numeric expression expected (got
`g')
std::regex_constants.3cxx.gz 200: warning: macro `,' not defined
std::student_t_distribution.3cxx.gz 76: warning: numeric expression expected
(got `r')
std::weibull_distribution.3cxx.gz 69: normal or special character expected (got
a space)
The one class of quoting problems seems to be fixed.
remaining:
include/std/istream:403: Returns @c getline(s,n,widen(apos;\napos;))
include/std/istream:363: Returns @c getline(s,n,widen(apos;\napos;))
include/std/istream:330: Returns @c get(s,n,widen(apos;\napos;))
which translates to:
.PP
Returns \fCget\fP(sb,widen('
.br
')).
.PP
quoting the backslash, I get this output (man not complaining anymore)
templatetypename _CharT, typename _Traits __istream_type
std::basic_istream _CharT, _Traits ::get
(char_type * __s, streamsize __n) [inline, inherited]
Simple multiple-character extraction. Parameters:
s Pointer to an array.
n Maximum number of characters to store in s.
Returns:
*this
Returns get(s,n,widen('\n')).
Definition at line 333 of file istream.
the other errors in the *distribution man pages are from using latex macros.
Matthias
--
http://gcc.gnu.org/bugzilla/show_bug.cgi?id=42460
[Bug libstdc++/42460] man page errors for generated libstdc++ man pages
--- Comment #20 from debian-gcc at lists dot debian dot org 2010-02-04 21:02 --- Created an attachment (id=19806) -- (http://gcc.gnu.org/bugzilla/attachment.cgi?id=19806action=view) fix \n quoting fixes the manual page, didn't check the html output -- http://gcc.gnu.org/bugzilla/show_bug.cgi?id=42460
[Bug libstdc++/42460] man page errors for generated libstdc++ man pages
--- Comment #14 from bkoz at gcc dot gnu dot org 2010-02-03 23:07 --- Got it Matthias, fixing, thanks for explaining what's up. How do you get these errors and validate the generated man pages? If it's a script can you attach it? Are you re-configuring doxygen? Or is this post-generation of the 'doc-man-doxygen' rule? -- http://gcc.gnu.org/bugzilla/show_bug.cgi?id=42460
[Bug libstdc++/42460] man page errors for generated libstdc++ man pages
--- Comment #15 from bkoz at gcc dot gnu dot org 2010-02-04 00:16 --- markup options /** * @brief Flags access. * @return The minimum field width to generate on output operations. * * Minimum field width refers to the number of characters. * * quot; * Minimum field width * quot; * refers to the number of characters. * * em * Minimum field width * /em * refers to the number of characters. * * @a Minimum field width * refers to the number of characters. */ -- http://gcc.gnu.org/bugzilla/show_bug.cgi?id=42460
[Bug libstdc++/42460] man page errors for generated libstdc++ man pages
--- Comment #13 from doko at ubuntu dot com 2010-01-21 14:30 ---
std::basic_ios.3, std::basic_ofstream.3, std::basic_ostream.3,
std::basic_ostringstream.3, std::ios_base.3:
.PP
Definition at line 657 of file ios_base.h.
.SS \fBstreamsize\fP std::ios_base::width () const\fC [inline, inherited]\fP
.PP
Flags access. \fBReturns:\fP
.RS 4
The minimum field width to generate on output operations.
.RE
.PP
'Minimum field width' refers to the number of characters.
.PP
The ' should be escaped as \', or else the paragraph is just discarded; unsure
how this should be formatted (quoting as \ for doxygen?). other places are
quotations from the standard, like:
src/libstdc++-v3/include/std/streambuf
* 'If it returns a positive value, then successive calls to
* @c underflow() will not return @c traits::eof() until at least that
* number of characters have been supplied. If @c showmanyc()
* returns -1, then calls to @c underflow() or @c uflow() will fail.'
* [27.5.2.4.3]/1
Extraction into another streambuf. \fBParameters:\fP
.RS 4
\fIsb\fP A streambuf in which to store data.
.RE
.PP
\fBReturns:\fP
.RS 4
*this
.RE
.PP
Returns \fCget\fP(sb,widen('
.br
')).
.PP
Definition at line 365 of file istream.
libstdc++-v3/include/std/istream
* Returns @c get(sb,widen('\n')).
unqoted quote and unqoted backslash, so make this ? There are other
places.
std::linear_congruential_engine.3
A random number generator that produces pseudorandom numbers using the linear
function $x_{i+1}\leftarrow(ax_{i} + c) \bmod m $.
std::exponential_distribution.3
The formula for the exponential probability density function is $ p(x|\lambda)
= \lambda e^{-\lambda x} $.
Tex is used instead of eqn. Didn't see a directive to not include this not for
the manpages.
So far, no bad checks from the checker, these all look like real problems.
--
http://gcc.gnu.org/bugzilla/show_bug.cgi?id=42460
[Bug libstdc++/42460] man page errors for generated libstdc++ man pages
--- Comment #10 from paolo dot carlini at oracle dot com 2010-01-20 13:12 --- Ok, let's close this one as fixed... -- paolo dot carlini at oracle dot com changed: What|Removed |Added Status|NEW |RESOLVED Resolution||FIXED Target Milestone|--- |4.5.0 http://gcc.gnu.org/bugzilla/show_bug.cgi?id=42460
[Bug libstdc++/42460] man page errors for generated libstdc++ man pages
--- Comment #11 from doko at ubuntu dot com 2010-01-20 13:58 --- the man pages still have problems with escape codes used (prefix backslashes); I didn't build and run the check tool yet again. Matthias -- http://gcc.gnu.org/bugzilla/show_bug.cgi?id=42460
[Bug libstdc++/42460] man page errors for generated libstdc++ man pages
--- Comment #12 from paolo dot carlini at oracle dot com 2010-01-20 14:00 --- Ok, let's re-open to be safe: please provide as soon as possible to Benjamin the information he needs... -- paolo dot carlini at oracle dot com changed: What|Removed |Added Status|RESOLVED|REOPENED Resolution|FIXED | http://gcc.gnu.org/bugzilla/show_bug.cgi?id=42460
[Bug libstdc++/42460] man page errors for generated libstdc++ man pages
--- Comment #8 from bkoz at gcc dot gnu dot org 2010-01-07 18:37 --- Created an attachment (id=19502) -- (http://gcc.gnu.org/bugzilla/attachment.cgi?id=19502action=view) log of man page creation -- http://gcc.gnu.org/bugzilla/show_bug.cgi?id=42460
[Bug libstdc++/42460] man page errors for generated libstdc++ man pages
--- Comment #9 from bkoz at gcc dot gnu dot org 2010-01-07 18:40 --- The rest of these look bogus to me. __gnu_cxx::enc_filebuf.3cxx 805: warning: macro `If' not defined __gnu_cxx::stdio_sync_filebuf.3cxx 699: warning: macro `If' not defined std::basic_filebuf.3cxx 905: warning: macro `If' not defined std::basic_ios.3cxx 1123: warning: macro `Minimum' not defined std::basic_istream.3cxx 988: warning: macro `)).' not defined std::basic_istringstream.3cxx 1011: warning: macro `)).' not defined std::basic_stringbuf.3cxx 723: warning: macro `If' not defined These look fine, and the generated file seems normal, ie this error looks like .PP If no file is currently open, this function immediately fails. .PP in the __gnu_cxx::enc_filebuf.3 file. So it looks like this can be closed to me but I'll wait for confirmation. -- bkoz at gcc dot gnu dot org changed: What|Removed |Added Status|UNCONFIRMED |NEW Ever Confirmed|0 |1 Last reconfirmed|-00-00 00:00:00 |2010-01-07 18:40:02 date|| http://gcc.gnu.org/bugzilla/show_bug.cgi?id=42460
[Bug libstdc++/42460] man page errors for generated libstdc++ man pages
--- Comment #5 from paolo dot carlini at oracle dot com 2010-01-06 11:41 --- Done both. -- http://gcc.gnu.org/bugzilla/show_bug.cgi?id=42460
[Bug libstdc++/42460] man page errors for generated libstdc++ man pages
--- Comment #6 from debian-gcc at lists dot debian dot org 2010-01-06 12:18 --- The Invalid or incomplete multibyte or wide character messages were generated due to an incorrect setup of the checking tool (lintian). -- http://gcc.gnu.org/bugzilla/show_bug.cgi?id=42460
[Bug libstdc++/42460] man page errors for generated libstdc++ man pages
--- Comment #7 from paolo dot carlini at oracle dot com 2010-01-06 16:39 --- Ok, thanks. Can you summarize the present status, then? Outstanding issues, maybe more patchlets... ;) -- http://gcc.gnu.org/bugzilla/show_bug.cgi?id=42460
[Bug libstdc++/42460] man page errors for generated libstdc++ man pages
--- Comment #3 from paolo dot carlini at oracle dot com 2009-12-30 01:21 --- Matthias, please apply your doc patchlet, thanks. -- http://gcc.gnu.org/bugzilla/show_bug.cgi?id=42460
[Bug libstdc++/42460] man page errors for generated libstdc++ man pages
--- Comment #4 from paolo dot carlini at oracle dot com 2009-12-30 02:01 --- Matthias, sorry, please apply only the first hunk, I'm applying momentarily the patch from Ed fixing the second issue. -- http://gcc.gnu.org/bugzilla/show_bug.cgi?id=42460
[Bug libstdc++/42460] man page errors for generated libstdc++ man pages
--- Comment #1 from debian-gcc at lists dot debian dot org 2009-12-22 11:40 --- Created an attachment (id=19368) -- (http://gcc.gnu.org/bugzilla/attachment.cgi?id=19368action=view) man pages with errors -- http://gcc.gnu.org/bugzilla/show_bug.cgi?id=42460
[Bug libstdc++/42460] man page errors for generated libstdc++ man pages
--- Comment #2 from debian-gcc at lists dot debian dot org 2009-12-22 11:42 --- Created an attachment (id=19369) -- (http://gcc.gnu.org/bugzilla/attachment.cgi?id=19369action=view) patch fixing two typos -- http://gcc.gnu.org/bugzilla/show_bug.cgi?id=42460
