<div dir="ltr"><div dir="ltr"><br></div><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On Fri, Feb 24, 2023 at 8:46 AM Rob Landley <<a href="mailto:rob@landley.net">rob@landley.net</a>> wrote:<br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">On 2/22/23 18:58, enh wrote:<br>
> On Wed, Feb 22, 2023 at 4:46 PM Rob Landley <<a href="mailto:rob@landley.net" target="_blank">rob@landley.net</a>> wrote:<br>
>><br>
>> On 2/22/23 15:52, enh wrote:<br>
>> > i've sent a patch upstream (with you cc:ed) anyway. (patches still<br>
>> > seem to get in without michael kerrisk --- it's "just" web site<br>
>> > updates that don't happen.<br>
>><br>
>> Apparently he handed off maintainership:<br>
>><br>
>>   <a href="https://www.spinics.net/lists/linux-man/msg24435.html" rel="noreferrer" target="_blank">https://www.spinics.net/lists/linux-man/msg24435.html</a><br>
>><br>
>> And indeed, he's listed as comaintainer at:<br>
>><br>
>>   <a href="https://www.kernel.org/doc/man-pages/maintaining.html" rel="noreferrer" target="_blank">https://www.kernel.org/doc/man-pages/maintaining.html</a><br>
>><br>
>> I dunno what the keys are for updating <a href="http://kernel.org/doc/man-pages" rel="noreferrer" target="_blank">kernel.org/doc/man-pages</a>. Many moons ago<br>
>> (<a href="http://landley.net/hg/kdocs" rel="noreferrer" target="_blank">http://landley.net/hg/kdocs</a>) I used to maintain <a href="http://kernel.org/doc" rel="noreferrer" target="_blank">kernel.org/doc</a> but I lost<br>
>> access after that whole <a href="http://kernel.org" rel="noreferrer" target="_blank">kernel.org</a> breakin and the move to kgit or whatever that<br>
>> nonsense was, since I could no longer rsync <a href="https://landley.net/kdocs" rel="noreferrer" target="_blank">https://landley.net/kdocs</a> up to the<br>
>> site.<br>
>><br>
>> I at least made puppy eyes at konstantin until he hacked up something for<br>
>> <a href="https://kernel.org/doc/html/" rel="noreferrer" target="_blank">https://kernel.org/doc/html/</a> and <a href="https://kernel.org/doc/Documentation/" rel="noreferrer" target="_blank">https://kernel.org/doc/Documentation/</a> and so on<br>
>> to update, and hey, he even salvaged the README finder, cool. Although my<br>
>> <a href="https://web.archive.org/web/20120121090059/http://www.kernel.org/doc/menuconfig/" rel="noreferrer" target="_blank">https://web.archive.org/web/20120121090059/http://www.kernel.org/doc/menuconfig/</a><br>
>> Horrible Python Script was beyond him and he wound up just removing that...<br>
>><br>
>> Anyway, back when I _did_ have access I created a man-pages subdirectory that<br>
>> Konstantin chowned so mkerrisk could write to it, but I dunno what he used to<br>
>> update it? Especially after I lost the ability to do so. (They wanted me to do<br>
>> some sort of "check your thing into git and it'll do an automated git checkout",<br>
>> and I was going "you took down Greg KH's 2 gigabyte tutorial video so I was<br>
>> gonna mirror it until it could get better hosting, do you really want that<br>
>> permanently in the git history even after I delete it again?" I blogged quite<br>
>> sarcastically about this at the time...)<br>
>><br>
>> Ha, the c99 html link is a bit stale there. I mean it's still there, but dude...<br>
>> Oh, the "legacy reasons" link moved, I'll ping konstantin. Huh, several of the<br>
>> links further down are broken now, not sure what to do about the linux-journal<br>
>> archives. The individual articles are still there but the index isn't...<br>
>><br>
>> > which is pretty debilitating for anyone who<br>
>> > doesn't have a local git clone of man-pages.git, which is "basically<br>
>> > everyone" :-( )<br>
>><br>
>> The new guy says it moved to:<br>
>><br>
>>   <a href="https://git.kernel.org/pub/scm/docs/man-pages/man-pages.git/" rel="noreferrer" target="_blank">https://git.kernel.org/pub/scm/docs/man-pages/man-pages.git/</a><br>
> <br>
> no, the _git_ project is fine. i've made several updates to that in<br>
> the last few years. they're just not making it out to<br>
> <a href="https://man7.org/linux/man-pages/man3/fseek.3.html" rel="noreferrer" target="_blank">https://man7.org/linux/man-pages/man3/fseek.3.html</a> which is where<br>
> people actually end up. (younger people especially seem to ask the<br>
> internet first rather than type `man foo`.)<br>
<br>
Sigh, <a href="https://www.kernel.org/doc/man-pages/" rel="noreferrer" target="_blank">https://www.kernel.org/doc/man-pages/</a> is all links _back_ to <a href="http://man7.org" rel="noreferrer" target="_blank">man7.org</a><br>
isn't it?<br>
<br>
Possibly the new maintainer needs to poke Konstantin to get access to update the<br>
directory, and then put stuff under the actual <a href="http://kernel.org" rel="noreferrer" target="_blank">kernel.org</a> page? (Or you could<br>
put some under an <a href="http://android.org" rel="noreferrer" target="_blank">android.org</a> location? Either way they'd be up to date with the<br>
repo instead of a couple years behind...)<br></blockquote><div><br></div><div>yeah, that's one of the options ... generate the html and stick it on one of the android-specific sites, but that seems a bit odd (people are already confused by places where the man pages are actually only talking about glibc; hosting them on an android site would only make that worse) and there are already a lot of links to <a href="http://man7.org">man7.org</a> out there in the wild, that it would be unfortunate to see go stale. (though if no-one has access to <a href="http://man7.org">man7.org</a> any more, there's nothing we can do about that anyway.)</div><div> </div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">
Let's see, how hard is it to produce html output from this git repo... it's got<br>
a top level Makefile to do exactly that as its default target, but it wants a<br>
package called "man2html". And installing that on my laptop installed apache<br>
which LAUNCHED AN INSTANCE ON LOOPBACK. Why on EARTH would... that's just sad.<br>
<br>
But ok, I can uninstall it again after building... looks like it populated<br>
tmp/html with files? No top level index. Let's see, the first file under "man3"<br>
is __after_morecore_hook.3.html which seems to be a synonym for malloc_hook (not<br>
symlinks or hardlinks, just redundantly generated files). The "Return to main<br>
contents" link goes to file:///cgi-bin/man/man2html which does not exist. The<br>
#include <malloc.h> link goes to file:///usr/include/malloc.h which ain't gonna<br>
work on a web server either...<br>
<br>
Looks like there's the start of something workable here, but it needs a bit of<br>
shoveling? (Or at least digging into how to configure it?)<br></blockquote><div><br></div><div>yeah, and one problem with being part of a large bureaucracy is that the docs folks and the branding folks will all want a say in making it look "right" if it's on an android site!</div><div> </div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">
>> > the bug is probably that it took us so long<br>
>> > to remove this cruft. (though we've had bytes are 8 bits for a while<br>
>> > now, and c23 finally guarantees two's complement!)<br>
>><br>
>> Oooh, does it? That's nice. Does this mean the stupid compiler "optimizing" out<br>
>> explicit checks for signed integer overflow will STOP DOING THAT?<br>
> <br>
> nope... that's still<br>
> <a href="https://thephd.dev/c-undefined-behavior-and-the-sledgehammer-guideline" rel="noreferrer" target="_blank">https://thephd.dev/c-undefined-behavior-and-the-sledgehammer-guideline</a><br>
<br>
I apply the sledgehammer to the compiler. (Push back against the abuser causing<br>
the damage, don't make the victims endlessly escalate ever-changing "compliance"<br>
that's never good enough. Danegeld encourages the dane.)<br></blockquote><div><br></div><div>read the link (or listen to what i've been telling you for the best part of a decade) --- the problem is that the compiler folks don't believe we're their customer. they don't care about "is it useful?", they care about "microbenchmark line goes up?". or, in your analogy "the law is currently on the abuser's side".</div><div> </div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">
>> Rob<br>
<br>
Still Rob<br>
</blockquote></div></div>