Re: /usr/share/man/man8/MAKEDEV.8
Matthew D. Fuller wrote: On Thu, Nov 01, 2007 at 01:43:41PM +0100 I heard the voice of Bernd Walter, and lo! it spake thus: Show me the positives that outweights the negatives and I'm on your side. Why do you think we're on different sides to begin with? I've not advocated removing catman capability, or denied that different situations have different needs, or that those needs may include catman, or for that matter said anything at all applicable to tiny environments or appliance building. As the author of the original statement creating this little furore, I don't think I said anything of the kind either! It's kind of depressing that a throwaway comment at the end of an email gets turned into a straw man argument that even I could have knocked down, but no-one has bothered to comment on the, to my mind, clear logic error in man/catman which allows the wrong manual page to get displayed in the first place. When the cat-ed man page concept was invented (when even the slowest machine cited here would have looked like science fiction) the notion that an upgrade process could install a manual page older than a pre-existing cat-ed version would have been unthinkable. With FreeBSD as it is now, it clearly isn't unthinkable since two experienced upgraders already had their own personal steps in the upgrade process to avoid the issue. At the very least, it would seem like adding that step to /usr/src/UPDATING and the handbook would be in order, but fixes to man and catman could make this issue happening a near impossibility. (A scheme using something like md5 sums could make it even more improbable, but hardly seems worth the effort). In addition, considering an *option* to simply not have cat-ed manual pages (for people with machines fast enough to just not care, or who have machines where you just don't read man pages often enough to care) does not seem out of order. An option. Not behaving like Microsoft. Not discriminating against anyone. On Thu, Nov 01, 2007 at 01:43:41PM +0100 Bernd Walter said: My point was against retirement, which was mentioned by Alex. No, it was not. I said: Of course, with modern systems where nroff-ing a man page takes negligible time and system resources, it could also be argued that cat-ed man pages should be a thing of the past with modern systems where nroff-ing a man page takes negligible time and system resources. All your arguments have been about systems which do not, by any stretch, meet that very specific criterion, and, for which, I therefore advocated nothing at all. If you had wanted a clarification, you only had to ask. jonathan michaels wrote: sorry for my noise, i am not complaining rather asking for a bit of thinkings and for some tolerance fro people who still use old machines .. I'm sorry that you've seen intolerance, but I assure you that none was intended. I think you are reading far more in to what was said, than was actually said. --Alex ___ freebsd-stable@freebsd.org mailing list http://lists.freebsd.org/mailman/listinfo/freebsd-stable To unsubscribe, send any mail to [EMAIL PROTECTED]
Re: /usr/share/man/man8/MAKEDEV.8
On Fri, Nov 02, 2007 at 11:28:43AM + I heard the voice of Alex Zbyslaw, and lo! it spake thus: In addition, considering an *option* to simply not have cat-ed manual pages (for people with machines fast enough to just not care, or who have machines where you just don't read man pages often enough to care) does not seem out of order. Actually, that's already happening much of the time. Rev 1.33 of src/gnu/usr.bin/man/man/Makefile (2001/01/15, in RELENG_5 and newer) turned off making man setuid by default, so it'll only make catpages when run as root anyway. Me, I solve it for base system manpages by having /usr mounted read-only. 8-} -- Matthew Fuller (MF4839) | [EMAIL PROTECTED] Systems/Network Administrator | http://www.over-yonder.net/~fullermd/ On the Internet, nobody can hear you scream. ___ freebsd-stable@freebsd.org mailing list http://lists.freebsd.org/mailman/listinfo/freebsd-stable To unsubscribe, send any mail to [EMAIL PROTECTED]
Re: /usr/share/man/man8/MAKEDEV.8
On Wed, Oct 31, 2007 at 02:30:45PM -0500, Matthew D. Fuller wrote: On Wed, Oct 31, 2007 at 08:08:31PM +0100 I heard the voice of Bernd Walter, and lo! it spake thus: I don't completly agree. Many people forget that FreeBSD is used on slow embedded systems as well and I prefer having manpoages there as well. Oh, I don't argue that there are cases where catpages are still useful. But I think they're the exception, not the rule. When you're setting up a tiny system (by whatever the standards of the given day are) or an appliance, you expect the tradeoffs to be rather different than on a normal (by said standards) general-purpose computer. My point was against retirement, which was mentioned by Alex. For me and many others slow systems are daily business. For many others modern systems are daily business, but those shouldn't think they are alone. We have already to face many slowdowns over the last years, such as the new rc.d system, which is painly slow on slow systems, but it has a real win, so I never complained against rc.d as such and I can live with it, since my systems rarely reboot. In case of catman retirement I just don't see the win, only the negative and just because many people don't see it doesn't mean it doesn't exist. Why do you expect me any tradeoff when there is nothing to trade? Show me the positives that outweights the negatives and I'm on your side. Heck, looking at Soekris, everything above the 4501 class is probably faster than my laptop8-} Yes - but the 4501 is not the slowest system we support. And - many people may be surprised - but the 4501 is extremly power hungry compared to what we can do with ARM. The difference between a 4501 and an at91rm9200 based system is nearly a factor three, so there are valid reasons for such a system. And the at91rm9200 is very compareable in speed when it comes to network traffic, although it seems to be unexpected slow on some other points. -- B.Walterhttp://www.bwct.de http://www.fizon.de [EMAIL PROTECTED] [EMAIL PROTECTED][EMAIL PROTECTED] ___ freebsd-stable@freebsd.org mailing list http://lists.freebsd.org/mailman/listinfo/freebsd-stable To unsubscribe, send any mail to [EMAIL PROTECTED]
Re: /usr/share/man/man8/MAKEDEV.8
On Thu, Nov 01, 2007 at 01:43:41PM +0100 I heard the voice of Bernd Walter, and lo! it spake thus: Show me the positives that outweights the negatives and I'm on your side. Why do you think we're on different sides to begin with? I've not advocated removing catman capability, or denied that different situations have different needs, or that those needs may include catman, or for that matter said anything at all applicable to tiny environments or appliance building. The sole and entire point of my mail was to provide a handful of data points supporting the idea that on new, not particularly new, and even pretty freakin' old normal computers, there's no pressing performance need for catman. That there exist people with even older systems where the situation is otherwise, or situations with new (but otherwise aimed) systems other than general purpose systems aimed at workstations and servers, is not something I've ever denied, but it's also not at all related to what I was talking about. None of my statements were ever INTENDED to be applied in those cases, so why should you be surprised that they're invalid there? -- Matthew Fuller (MF4839) | [EMAIL PROTECTED] Systems/Network Administrator | http://www.over-yonder.net/~fullermd/ On the Internet, nobody can hear you scream. ___ freebsd-stable@freebsd.org mailing list http://lists.freebsd.org/mailman/listinfo/freebsd-stable To unsubscribe, send any mail to [EMAIL PROTECTED]
Re: /usr/share/man/man8/MAKEDEV.8
On Tue, Oct 30, 2007 at 10:23:58AM + I heard the voice of Alex Zbyslaw, and lo! it spake thus: Of course, with modern systems where nroff-ing a man page takes negligible time and system resources, it could also be argued that cat-ed man pages should be a thing of the past :-) Quite. The slowest machine I currently have running (to get slower, I'd have to dig in my closet) is my laptop, which is a P54 Pentium 133MHz, with 32 megs of RAM and a hard drive that runs in PIO mode. It's running a 2002-vintage RELENG_4, on which the largest manpage is perlfunc(1) (at 71k). On the first run without the manpage in cache: % time sh -c 'man perlfunc /dev/null' 6.881u 0.204s 0:07.22 98.0% 173+581k 8+0io 0pf+0w A while, but hardly an eternity. A more typical manpage like ls takes 3 seconds. On a less ancient machine (but still a few generations back; Athlon 1.25GHz, few month old RELENG_6), the biggest manpage is perltoc(1) at 150k. A cold cache run there takes just over 2 seconds. On my workstation (dual Athlon 1.4, HEAD), I've got wireshark-filter(4) at a whopping 746k. That takes about 8 seconds. Second place is gcc at 158k, which takes about 1. So, yes; outside of rather special cases, catpages deserve to enjoy their retirement at this point 8-} -- Matthew Fuller (MF4839) | [EMAIL PROTECTED] Systems/Network Administrator | http://www.over-yonder.net/~fullermd/ On the Internet, nobody can hear you scream. ___ freebsd-stable@freebsd.org mailing list http://lists.freebsd.org/mailman/listinfo/freebsd-stable To unsubscribe, send any mail to [EMAIL PROTECTED]
Re: /usr/share/man/man8/MAKEDEV.8
On 2007-10-30 18:26, Giorgos Keramidas [EMAIL PROTECTED] wrote: There are also a couple of manpages with references to very long URIs, which cannot be wrapped by nroff in a reasonable line-length: ng_netflow.4 bluetooth.device.conf.5 I don't think we can easily fix these, without manually wrapping the URIs, but that may 'break' copy/pasting of the URIs :/ Fixed with a bit of help from our resident groff-guru, Ruslan :) ___ freebsd-stable@freebsd.org mailing list http://lists.freebsd.org/mailman/listinfo/freebsd-stable To unsubscribe, send any mail to [EMAIL PROTECTED]
Re: /usr/share/man/man8/MAKEDEV.8
On Wed, Oct 31, 2007 at 08:08:31PM +0100 I heard the voice of Bernd Walter, and lo! it spake thus: I don't completly agree. Many people forget that FreeBSD is used on slow embedded systems as well and I prefer having manpoages there as well. Oh, I don't argue that there are cases where catpages are still useful. But I think they're the exception, not the rule. When you're setting up a tiny system (by whatever the standards of the given day are) or an appliance, you expect the tradeoffs to be rather different than on a normal (by said standards) general-purpose computer. Heck, looking at Soekris, everything above the 4501 class is probably faster than my laptop8-} -- Matthew Fuller (MF4839) | [EMAIL PROTECTED] Systems/Network Administrator | http://www.over-yonder.net/~fullermd/ On the Internet, nobody can hear you scream. ___ freebsd-stable@freebsd.org mailing list http://lists.freebsd.org/mailman/listinfo/freebsd-stable To unsubscribe, send any mail to [EMAIL PROTECTED]
Re: /usr/share/man/man8/MAKEDEV.8
On Wed, Oct 31, 2007 at 09:39:23AM -0500, Matthew D. Fuller wrote: On Tue, Oct 30, 2007 at 10:23:58AM + I heard the voice of Alex Zbyslaw, and lo! it spake thus: Of course, with modern systems where nroff-ing a man page takes negligible time and system resources, it could also be argued that cat-ed man pages should be a thing of the past :-) Quite. I don't completly agree. Many people forget that FreeBSD is used on slow embedded systems as well and I prefer having manpoages there as well. The slowest machine I currently have running (to get slower, I'd have to dig in my closet) is my laptop, which is a P54 Pentium 133MHz, with 32 megs of RAM and a hard drive that runs in PIO mode. It's running a 2002-vintage RELENG_4, on which the largest manpage is perlfunc(1) (at 71k). On the first run without the manpage in cache: % time sh -c 'man perlfunc /dev/null' 6.881u 0.204s 0:07.22 98.0% 173+581k 8+0io 0pf+0w [73]arm9# time sh -c 'man perlfunc /dev/null' Formatting page, please wait...Done. 76.000u 5.000s 3:21.21 40.8%2269+36014k 35+1io 27pf+0w [74]arm9# time sh -c 'man ls /dev/null' Formatting page, please wait...Done. 15.000u 1.000s 0:45.48 38.3%3286+30833k 18+1io 1pf+0w This was on an AT91RM9200 based system. It wasn't completely idle, since it is currently routing my DSL connection, but you get the point. A while, but hardly an eternity. A more typical manpage like ls takes 3 seconds. On a less ancient machine (but still a few generations back; Athlon 1.25GHz, few month old RELENG_6), the biggest manpage is perltoc(1) at 150k. A cold cache run there takes just over 2 seconds. On my workstation (dual Athlon 1.4, HEAD), I've got wireshark-filter(4) at a whopping 746k. That takes about 8 seconds. Second place is gcc at 158k, which takes about 1. So, yes; outside of rather special cases, catpages deserve to enjoy their retirement at this point 8-} arm based FreeBSD is not that common, but 486 classed systems like Soekris are very commonly used. I wouldn't call it that special. -- B.Walterhttp://www.bwct.de http://www.fizon.de [EMAIL PROTECTED] [EMAIL PROTECTED][EMAIL PROTECTED] ___ freebsd-stable@freebsd.org mailing list http://lists.freebsd.org/mailman/listinfo/freebsd-stable To unsubscribe, send any mail to [EMAIL PROTECTED]
Re: /usr/share/man/man8/MAKEDEV.8
On Wed, Oct 31, 2007 at 02:30:45PM -0500, Matthew D. Fuller wrote: On Wed, Oct 31, 2007 at 08:08:31PM +0100 I heard the voice of Bernd Walter, and lo! it spake thus: I don't completly agree. Many people forget that FreeBSD is used on slow embedded systems as well and I prefer having manpoages there as well. given microsofts new operating system release of late and the even greater dependance on far more expensive computers, is leaving the computer world 'underclass' with even less choice so to speak. i deal with a group of disabled people (i too have significant disabilities) that are finding ther increasing reliance on computers to deal with the needs of everyday lives .. beacue it is assumed that 'everybody' has access to teh internet and more and more govt beurocracys are putting ther infromation up on teh internet and not making any consessions for people who haven't that kind of accessability, either because of cost of isp, cost of raw computing power, toc of teh computing 'experience' and so on. Oh, I don't argue that there are cases where catpages are still useful. But I think they're the exception, not the rule. When you're setting up a tiny system (by whatever the standards of the given day are) or an appliance, you expect the tradeoffs to be rather different no, i disagree, i expect my operating system to be usable and to be consistant in its ability to interoperate with my abilaty to use it with teh resources at my disposal .. human/financial/accessibility than on a normal (by said standards) general-purpose computer. and what is normal ?? while i was fortunate enough to be able to aquire a reasonable workhorse not all people in my situation are so fortunate. sorry for my noise, i am not complaining rather asking for a bit of thinkings and for some tolerance fro people who still use old machines .. as teh world moves into a situation normal information/govt services is only delivered by automatied computer delivery systems greater sections of teh community ar going to be isolated form this new world because tehy cannot get teh tools to access what is ever increasingly concider teh normal way of doing things Heck, looking at Soekris, everything above the 4501 class is probably faster than my laptop8-} perhaps, many people, not those only on the fringe of society do not have computer systems that even make it to that meager standard to paraphrase a .sig i have seen often in these parts, standards are wonderfull things, there are so many to choose from !! regards appreciations and thanks for all your efforts in making a freebsd that i can still use and actually find enjoyable. cheers jonathan -- powered by .. QNX, OS9 and freeBSD -- http://caamora com au/operating system === appropriate solution in an inappropriate world === ___ freebsd-stable@freebsd.org mailing list http://lists.freebsd.org/mailman/listinfo/freebsd-stable To unsubscribe, send any mail to [EMAIL PROTECTED]
Re: /usr/share/man/man8/MAKEDEV.8
* Jeremy Chadwick ([EMAIL PROTECTED]) wrote:
There's a periodic script (/etc/periodic/weekly/330.catman) which
rebuilds all the catman pages for you. However, it makes an immense
mess of your weekly system mails due to all the manpage/nroff
formatting mistakes. Have a look:
http://lists.freebsd.org/pipermail/freebsd-ports/2007-May/040648.html
If you want to find what's causing these errors, you could run catman
with -v so it prints the filename of what it's processing.
Less spammy but still noisy in the event of these warnings would be
something like the attached patch, which saves the stderr stream and
prints it and the currently processed filename if it's non-empty.
Maybe friendlier would be the other patch, which silences nroff unless
catman is running verbose.
--
Thomas 'Freaky' Hurst
http://hur.st/
--- catman.c.orig 2007-10-30 04:43:52.0 +
+++ catman.c 2007-10-30 04:45:35.0 +
@@ -403,6 +403,10 @@
dev_t src_dev;
ino_t src_ino;
const char *link_name;
+ struct stat err_st;
+ char err_file[MAXPATHLEN];
+ int err_fd;
+ char err_buf[1024];
src_test = test_path(src, src_mtime);
if (!(src_test (TEST_FILE|TEST_READABLE))) {
@@ -447,13 +451,33 @@
}
snprintf(tmp_file, sizeof tmp_file, %s.tmp, cat);
snprintf(cmd, sizeof cmd,
- %scat %s | tbl | nroff -T%s -man | col | %s %s.tmp,
+ %scat %s | tbl | nroff -T%s -man 2%s.err | col | %s %s.tmp,
zipped == BZIP ? BZ2CAT_CMD : zipped == GZIP ? GZCAT_CMD : ,
- src, nroff_device,
+ src, nroff_device, cat,
zipped == BZIP ? BZ2_CMD : zipped == GZIP ? GZ_CMD : cat,
cat);
if (system(cmd) != 0)
err(1, formatting pipeline);
+
+ snprintf(err_file, sizeof err_file, %s.err, cat);
+ if (stat(err_file, err_st) 0)
+ warn(%s, err_file);
+ else if (err_st.st_size 0)
+ {
+ fprintf(stderr, nroff formatting errors in %s:\n, src);
+ if ((err_fd = open(err_file, O_RDONLY)) 0)
+ warn(%s, err_file);
+ else
+ {
+ while (read(err_fd, err_buf, sizeof err_buf) 0)
+fprintf(stderr, %s, err_buf);
+
+ close(err_fd);
+ }
+ }
+ if (unlink(err_file) 0)
+ warn(%s, err_file);
+
if (rename(tmp_file, cat) 0)
warn(%s, cat);
tmp_file[0] = '\0';
--- catman.c 2007-10-30 05:05:04.0 +
+++ catman.c.orig 2007-10-30 04:43:52.0 +
@@ -447,9 +447,9 @@
}
snprintf(tmp_file, sizeof tmp_file, %s.tmp, cat);
snprintf(cmd, sizeof cmd,
- %scat %s | tbl | nroff -T%s -man %s| col | %s %s.tmp,
+ %scat %s | tbl | nroff -T%s -man | col | %s %s.tmp,
zipped == BZIP ? BZ2CAT_CMD : zipped == GZIP ? GZCAT_CMD : ,
- src, nroff_device, verbose ? : 2/dev/null,
+ src, nroff_device,
zipped == BZIP ? BZ2_CMD : zipped == GZIP ? GZ_CMD : cat,
cat);
if (system(cmd) != 0)
___
freebsd-stable@freebsd.org mailing list
http://lists.freebsd.org/mailman/listinfo/freebsd-stable
To unsubscribe, send any mail to [EMAIL PROTECTED]
Re: /usr/share/man/man8/MAKEDEV.8
On Sun, 28 Oct 2007, Andrew Lankford wrote: Thbbt! I'm reading the catman version of MAKEDEV. I'll try posting this one more time. :) Before you installworld, just do 'rm -r /usr/share/man/' and you won't ever have that problem. Doug -- This .signature sanitized for your protection ___ freebsd-stable@freebsd.org mailing list http://lists.freebsd.org/mailman/listinfo/freebsd-stable To unsubscribe, send any mail to [EMAIL PROTECTED]
Re: /usr/share/man/man8/MAKEDEV.8
Giorgos Keramidas wrote:
On 2007-10-28 12:54, Andrew Lankford [EMAIL PROTECTED] wrote:
Thbbt! I'm reading the catman version of MAKEDEV. Wish I could
disable that feature. Oh well. I'll delete it all and rebuild it
again if needed. Thanks!
Ah, that's it then :)
My usual `installworld' steps include this too:
# cd /usr/share/man
# find cat[0-9] \! -type d -exec rm {} +
This takes care of deleting any `stale' preformatted manpages, so the
next time I ask for a manpage, it's going to be reformatted.
Seems to me that there must a logic error in man. Man makes the effort
to check to see if the unformatted manpage is newer than the cat-ed
manpage, and if it is, it will try to re-create the cat-ed manpage, and
will show you an nroff'ed version of the unformatted manpage if it
cannot recreate the cat-ed version.
Clearly that's breaking in this scenario, because the mtime of the new
unformatted manpage, while presumably newer than that of the old
unformatted man page is still older than the mtime of the cat-ed page.
What seems to be missing, is that when the cat-ed manpage is first
created, it should have its mtime set to the same as the mtime of the
unformatted manpage, not the time at which you happened to read the man
page. I don't see any evidence of that is the sources on my system
(which is quite old, but it certainly looks like the bug persists).
A bit of stat and utimes jiggery pokery looks like it would solve this
problem. An else clause forelse if (rename(temp, cat_file) == -1)
{ in /usr/src/gnu/usr.bin/man/man/man.c would look like the place to do
that.
(Alternatively, you could view it as a bug of the install/upgrade
process, since it could be argued that the mtime of the unformatted
manpage should be the time that the manpage was installed. Presumably
that isn't happening, else you wouldn't be seeing the cat-ed version).
Of course, with modern systems where nroff-ing a man page takes
negligible time and system resources, it could also be argued that
cat-ed man pages should be a thing of the past :-)
--Alex
___
freebsd-stable@freebsd.org mailing list
http://lists.freebsd.org/mailman/listinfo/freebsd-stable
To unsubscribe, send any mail to [EMAIL PROTECTED]
Re: /usr/share/man/man8/MAKEDEV.8
On 2007-10-29 12:18, Jeremy Chadwick [EMAIL PROTECTED] wrote:
On Mon, Oct 29, 2007 at 03:24:47PM +0200, Giorgos Keramidas wrote:
On 2007-10-28 12:54, Andrew Lankford [EMAIL PROTECTED] wrote:
Thbbt! I'm reading the catman version of MAKEDEV. Wish I could
disable that feature. Oh well. I'll delete it all and rebuild it
again if needed. Thanks!
Ah, that's it then :)
My usual `installworld' steps include this too:
# cd /usr/share/man
# find cat[0-9] \! -type d -exec rm {} +
There's a periodic script (/etc/periodic/weekly/330.catman) which
rebuilds all the catman pages for you. However, it makes an immense
mess of your weekly system mails due to all the manpage/nroff formatting
mistakes. Have a look:
http://lists.freebsd.org/pipermail/freebsd-ports/2007-May/040648.html
Very interesting. Maybe we can tweak 330.catman to display the filename
of the manpage which causes each error. Then we could use the periodic
script as an aid to start actually *fixing* the errors :)
___
freebsd-stable@freebsd.org mailing list
http://lists.freebsd.org/mailman/listinfo/freebsd-stable
To unsubscribe, send any mail to [EMAIL PROTECTED]
Re: /usr/share/man/man8/MAKEDEV.8
On 2007-10-30 13:32, Giorgos Keramidas [EMAIL PROTECTED] wrote: http://lists.freebsd.org/pipermail/freebsd-ports/2007-May/040648.html Very interesting. Maybe we can tweak 330.catman to display the filename of the manpage which causes each error. Then we could use the periodic script as an aid to start actually *fixing* the errors :) Neat. The base-system manpages which have errors or warnings are just a few of the hundreds we have. I just finished running a slightly modified version of `/etc/periodic/weekly/330.catman', which uses `catman -v' and the list of files with errors (after a bit of manual parsing) is now: % Reformatting manual pages: % /usr/share/man: not writable - will only be able to write to existing cat directories % man directory /usr/share/man % section man1 % format man1/readelf.1.gz - cat1/readelf.1.gz % standard input:151: warning [p 1, 3.8i]: cannot adjust line % standard input:300: warning [p 2, 9.7i, div `an-div', 0.0i]: cannot adjust line % standard input:300: warning [p 2, 9.7i]: cannot adjust line % section man2 % format man2/minherit.2.gz - cat2/minherit.2.gz % mdoc warning: .Fx: Unknown FreeBSD version `2.2.0' (#132) % format man2/sctp_generic_recvmsg.2.gz - cat2/sctp_generic_recvmsg.2.gz % mdoc warning: Empty input line #76 % format man2/sctp_generic_sendmsg.2.gz - cat2/sctp_generic_sendmsg.2.gz % mdoc warning: Empty input line #51 % mdoc warning: Empty input line #88 % format man2/sctp_peeloff.2.gz - cat2/sctp_peeloff.2.gz % mdoc warning: Empty input line #82 % section man3 % format man3/ether_aton.3.gz - cat3/ether_aton.3.gz % mdoc warning: Empty input line #169 % format man3/gss_add_cred.3.gz - cat3/gss_add_cred.3.gz % Not a \-mdoc command: .PP (#89) % format man3/gss_inquire_cred_by_mech.3.gz - cat3/gss_inquire_cred_by_mech.3.gz % mdoc warning: Empty input line #72 % format man3/gss_inquire_mechs_for_name.3.gz - cat3/gss_inquire_mechs_for_name.3.gz % mdoc warning: Empty input line #50 % format man3/gss_seal.3.gz - cat3/gss_seal.3.gz % mdoc warning: A .Bl directive has no matching .El (#146) % format man3/gss_unseal.3.gz - cat3/gss_unseal.3.gz % mdoc warning: A .Bl directive has no matching .El (#159) % format man3/gss_wrap_size_limit.3.gz - cat3/gss_wrap_size_limit.3.gz % mdoc warning: A .Bl directive has no matching .El (#131) % format man3/lwres_gabn.3.gz - cat3/lwres_gabn.3.gz % standard input:45: warning [p 1, 5.2i]: can't break line % format man3/lwres_gnba.3.gz - cat3/lwres_gnba.3.gz % standard input:45: warning [p 1, 5.2i]: can't break line % format man3/lwres_noop.3.gz - cat3/lwres_noop.3.gz % standard input:45: warning [p 1, 5.2i]: can't break line % format man3/valloc.3.gz - cat3/valloc.3.gz % mdoc warning: Extraneous .Ef (#49) % format man3/zlib.3.gz - cat3/zlib.3.gz % standard input:52: warning [p 1, 7.0i]: cannot adjust line % section man4 % format man4/mac.4.gz - cat4/mac.4.gz % mdoc warning: extraneous .El call (#200) % format man4/md.4.gz - cat4/md.4.gz % mdoc warning: Unknown keyword `-ofset' in .Bd macro (#68) % mdoc warning: Unknown keyword `indent' in .Bd macro (#68) % format man4/ng_netflow.4.gz - cat4/ng_netflow.4.gz % standard input:254: warning [p 3, 3.3i]: can't break line % section man5 % format man5/bluetooth.device.conf.5.gz - cat5/bluetooth.device.conf.5.gz % standard input:93: warning [p 1, 7.2i]: can't break line % format man5/quota.group.5.gz - cat5/quota.group.5.gz % mdoc warning: Unknown keyword `-indent' in .Bl macro (#53) % mdoc warning: Unknown keyword `offset' in .Bl macro (#53) % section man8 % format man8/fwcontrol.8.gz - cat8/fwcontrol.8.gz % mdoc warning: Empty input line #179 % format man8/ifmcstat.8.gz - cat8/ifmcstat.8.gz % mdoc warning: A .Bl directive has no matching .El (#82) % section man9 % format man9/uio.9.gz - cat9/uio.9.gz % mdoc warning: A .Bl directive has no matching .El (#129) % link cat9/zpfind.9.gz - cat9/pfind.9.gz These are just the manpages of the base-system. I think I can handle most of them, so I started patching the non-contrib stuff. - Giorgos ___ freebsd-stable@freebsd.org mailing list http://lists.freebsd.org/mailman/listinfo/freebsd-stable To unsubscribe, send any mail to [EMAIL PROTECTED]
Re: /usr/share/man/man8/MAKEDEV.8
On 2007-10-30 14:16, Giorgos Keramidas [EMAIL PROTECTED] wrote: Neat. The base-system manpages which have errors or warnings are just a few of the hundreds we have. I just finished running a slightly modified version of `/etc/periodic/weekly/330.catman', which uses `catman -v' and the list of files with errors (after a bit of manual parsing) is now: % Reformatting manual pages: % /usr/share/man: not writable - will only be able to write to existing cat directories % [...] Hi again Jeremy. The 'trigger' for using 330.catman and catman -v was very useful indeed :) I've fixed the following manpages in CURRENT, and will MFC the changes after a while (given RE approval for RELENG_7): minherit.2, sctp_generic_recvmsg.2, sctp_generic_sendmsg.2, sctp_peeloff.2, ether_aton.3, gss_add_cred.3, gss_inquire_cred_by_mech.3, gss_inquire_mechs_for_name.3, gss_seal.3, gss_unseal.3, gss_wrap_size_limit.3, valloc.3, mac.4, md.4, quota.group.5, fwcontrol.8, ifmcstat.8, uio.9 There are still some errors/warnings in contrib manpages, like: readelf.1(binutils) lwres_gabn.3 (bind) lwres_gnba.3 (bind) lwres_noop.3 (bind) zlib.3 (zlib) I'll ask the respective contrib-code maintainers before making changes here, to avoid taking files off the vendor branch if it's too bad. There are also a couple of manpages with references to very long URIs, which cannot be wrapped by nroff in a reasonable line-length: ng_netflow.4 bluetooth.device.conf.5 I don't think we can easily fix these, without manually wrapping the URIs, but that may 'break' copy/pasting of the URIs :/ - Giorgos ___ freebsd-stable@freebsd.org mailing list http://lists.freebsd.org/mailman/listinfo/freebsd-stable To unsubscribe, send any mail to [EMAIL PROTECTED]
Re: /usr/share/man/man8/MAKEDEV.8
On 2007-10-28 12:54, Andrew Lankford [EMAIL PROTECTED] wrote:
Thbbt! I'm reading the catman version of MAKEDEV. Wish I could
disable that feature. Oh well. I'll delete it all and rebuild it
again if needed. Thanks!
Ah, that's it then :)
My usual `installworld' steps include this too:
# cd /usr/share/man
# find cat[0-9] \! -type d -exec rm {} +
This takes care of deleting any `stale' preformatted manpages, so the
next time I ask for a manpage, it's going to be reformatted.
___
freebsd-stable@freebsd.org mailing list
http://lists.freebsd.org/mailman/listinfo/freebsd-stable
To unsubscribe, send any mail to [EMAIL PROTECTED]
Re: /usr/share/man/man8/MAKEDEV.8
On Mon, Oct 29, 2007 at 03:24:47PM +0200, Giorgos Keramidas wrote:
On 2007-10-28 12:54, Andrew Lankford [EMAIL PROTECTED] wrote:
Thbbt! I'm reading the catman version of MAKEDEV. Wish I could
disable that feature. Oh well. I'll delete it all and rebuild it
again if needed. Thanks!
Ah, that's it then :)
My usual `installworld' steps include this too:
# cd /usr/share/man
# find cat[0-9] \! -type d -exec rm {} +
There's a periodic script (/etc/periodic/weekly/330.catman) which
rebuilds all the catman pages for you. However, it makes an immense
mess of your weekly system mails due to all the manpage/nroff formatting
mistakes. Have a look:
http://lists.freebsd.org/pipermail/freebsd-ports/2007-May/040648.html
--
| Jeremy Chadwickjdc at parodius.com |
| Parodius Networking http://www.parodius.com/ |
| UNIX Systems Administrator Mountain View, CA, USA |
| Making life hard for others since 1977. PGP: 4BD6C0CB |
___
freebsd-stable@freebsd.org mailing list
http://lists.freebsd.org/mailman/listinfo/freebsd-stable
To unsubscribe, send any mail to [EMAIL PROTECTED]
Re: /usr/share/man/man8/MAKEDEV.8
On Sun, Oct 28, 2007 at 12:03:33AM -0400, Andrew Lankford wrote: I just noticed that /usr/share/man/man8/MAKEDEV.8 is still in the FreeBSD-7 tree. Is this intentional? It still says that MAKEDEV is located in /dev and mentions MAKEDEV.local as well. Could it be that you have updated this machine from RELENG_4? The fact that the file you're referring to has no .gz extention show that it's stale, manpages have been compressed for some time now. Also, I was the one who removed the original MAKEDEV.8 manpage, so I know ;-) After the removal, a small new one was added to refer people to devfs-related material. - Christian -- Christian Brueffer [EMAIL PROTECTED] [EMAIL PROTECTED] GPG Key: http://people.freebsd.org/~brueffer/brueffer.key.asc GPG Fingerprint: A5C8 2099 19FF AACA F41B B29B 6C76 178C A0ED 982D pgp1qNF06hdiz.pgp Description: PGP signature
Re: /usr/share/man/man8/MAKEDEV.8
On Sun, 28 Oct 2007, Christian Brueffer wrote: On Sun, Oct 28, 2007 at 12:03:33AM -0400, Andrew Lankford wrote: I just noticed that /usr/share/man/man8/MAKEDEV.8 is still in the FreeBSD-7 tree. Is this intentional? It still says that MAKEDEV is located in /dev and mentions MAKEDEV.local as well. Could it be that you have updated this machine from RELENG_4? The fact that the file you're referring to has no .gz extention show that it's stale, manpages have been compressed for some time now. A simple way to make sure you don't get bitten by this is to 'rm -r /usr/share/man' right before you do 'make installworld'. (Or you can mv it if you're paranoid, I've been deleting it for a long time now and it's never bitten me.) hth, Doug -- This .signature sanitized for your protection ___ freebsd-stable@freebsd.org mailing list http://lists.freebsd.org/mailman/listinfo/freebsd-stable To unsubscribe, send any mail to [EMAIL PROTECTED]
Re: /usr/share/man/man8/MAKEDEV.8
Thanks for replying, but once again I've miscommunicated the issue. I meant that MAKEDEV.8 is in /usr/src/share/man/man8/, and the modification time is Oct 13th, recent, which suggests to me that it's still in the 7.0-BETA1 cvs tree. Andrew Lankford Doug Barton wrote: On Sun, 28 Oct 2007, Christian Brueffer wrote: On Sun, Oct 28, 2007 at 12:03:33AM -0400, Andrew Lankford wrote: I just noticed that /usr/share/man/man8/MAKEDEV.8 is still in the FreeBSD-7 tree. Is this intentional? It still says that MAKEDEV is located in /dev and mentions MAKEDEV.local as well. Could it be that you have updated this machine from RELENG_4? The fact that the file you're referring to has no .gz extention show that it's stale, manpages have been compressed for some time now. A simple way to make sure you don't get bitten by this is to 'rm -r /usr/share/man' right before you do 'make installworld'. (Or you can mv it if you're paranoid, I've been deleting it for a long time now and it's never bitten me.) hth, Doug ___ freebsd-stable@freebsd.org mailing list http://lists.freebsd.org/mailman/listinfo/freebsd-stable To unsubscribe, send any mail to [EMAIL PROTECTED]
Re: /usr/share/man/man8/MAKEDEV.8
On Sun, Oct 28, 2007 at 12:37:45PM -0400, Andrew Lankford wrote: Thanks for replying, but once again I've miscommunicated the issue. I meant that MAKEDEV.8 is in /usr/src/share/man/man8/, and the modification time is Oct 13th, recent, which suggests to me that it's still in the 7.0-BETA1 cvs tree. And you're very much correct: http://www.freebsd.org/cgi/cvsweb.cgi/src/share/man/man8/MAKEDEV.8 -- | Jeremy Chadwickjdc at parodius.com | | Parodius Networking http://www.parodius.com/ | | UNIX Systems Administrator Mountain View, CA, USA | | Making life hard for others since 1977. PGP: 4BD6C0CB | ___ freebsd-stable@freebsd.org mailing list http://lists.freebsd.org/mailman/listinfo/freebsd-stable To unsubscribe, send any mail to [EMAIL PROTECTED]
Re: /usr/share/man/man8/MAKEDEV.8
Danny Braniss wrote: On Sun, Oct 28, 2007 at 12:37:45PM -0400, Andrew Lankford wrote: Thanks for replying, but once again I've miscommunicated the issue. I meant that MAKEDEV.8 is in /usr/src/share/man/man8/, and the modification time is Oct 13th, recent, which suggests to me that it's still in the 7.0-BETA1 cvs tree. And you're very much correct: http://www.freebsd.org/cgi/cvsweb.cgi/src/share/man/man8/MAKEDEV.8 how about reading what ity says? it might be very educational :-) NAME MAKEDEV -- old script for creating device nodes DESCRIPTION The MAKEDEV script was deprecated by devfs(5) and removed from FreeBSD after devfs(5) became mandatory. ___ freebsd-stable@freebsd.org mailing list http://lists.freebsd.org/mailman/listinfo/freebsd-stable To unsubscribe, send any mail to [EMAIL PROTECTED]
Re: /usr/share/man/man8/MAKEDEV.8
Thbbt! I'm reading the catman version of MAKEDEV. Wish I could disable that feature. Oh well. I'll delete it all and rebuild it again if needed. Thanks! Andrew Lankford Danny Braniss wrote: On Sun, Oct 28, 2007 at 12:37:45PM -0400, Andrew Lankford wrote: Thanks for replying, but once again I've miscommunicated the issue. I meant that MAKEDEV.8 is in /usr/src/share/man/man8/, and the modification time is Oct 13th, recent, which suggests to me that it's still in the 7.0-BETA1 cvs tree. And you're very much correct: http://www.freebsd.org/cgi/cvsweb.cgi/src/share/man/man8/MAKEDEV.8 how about reading what ity says? it might be very educational :-) NAME MAKEDEV -- old script for creating device nodes DESCRIPTION The MAKEDEV script was deprecated by devfs(5) and removed from FreeBSD after devfs(5) became mandatory. ___ freebsd-stable@freebsd.org mailing list http://lists.freebsd.org/mailman/listinfo/freebsd-stable To unsubscribe, send any mail to [EMAIL PROTECTED]
Re: /usr/share/man/man8/MAKEDEV.8
On Sun, Oct 28, 2007 at 12:37:45PM -0400, Andrew Lankford wrote: Thanks for replying, but once again I've miscommunicated the issue. I meant that MAKEDEV.8 is in /usr/src/share/man/man8/, and the modification time is Oct 13th, recent, which suggests to me that it's still in the 7.0-BETA1 cvs tree. And you're very much correct: http://www.freebsd.org/cgi/cvsweb.cgi/src/share/man/man8/MAKEDEV.8 how about reading what ity says? it might be very educational :-) NAME MAKEDEV -- old script for creating device nodes DESCRIPTION The MAKEDEV script was deprecated by devfs(5) and removed from FreeBSD after devfs(5) became mandatory. ___ freebsd-stable@freebsd.org mailing list http://lists.freebsd.org/mailman/listinfo/freebsd-stable To unsubscribe, send any mail to [EMAIL PROTECTED]
