Merge pull request #2740 from xexyl/rosten01

2024-11-01 07:54:01 -07:00
commit 4ef6477643
@@ -37,6 +37,14 @@
            "display_via_github" : true,
            "entry_text" : "original source code"
        },
+        {
+            "file_path" : "greasymouse.man",
+            "inventory_order" : 150,
+            "OK_to_edit" : true,
+            "display_as" : "man",
+            "display_via_github" : true,
+            "entry_text" : "cat man page"
+        },
        {
            "file_path" : "2001_rosten.tar.bz2",
            "inventory_order" : 1415926535,
@@ -14,7 +14,6 @@ FAQ on "[X11](../../faq.html#X11)".
 The current status of this entry is:

 > **STATUS: INABIAF - please DO NOT fix**<br>
-> **STATUS: missing files - please provide them**<br>

 For more detailed information see [2001/rosten in bugs.html](../../bugs.html#2001_rosten).

@@ -72,7 +71,8 @@ obfuscated. Try doing something mouse driven (such as using a mouse
 driven editor on this program) whilst it is running. If you're not sure
 what it does, looking at the code should give a fair idea.

-It also has a [cat] man page if you want to install it as a 'utility'.
+The file [greasymouse.man](%%REPO_URL%%/2001/rosten/greasymouse.man) is a cat
+man page if you want to install it as a 'utility'.


 ### OPTIONS
@@ -0,0 +1,115 @@
+
+NAME
+    
+    greasymouse - make the mouse act as if it has been greased
+
+SYNOPSIS
+     
+    greasymouse [greasiness]
+
+
+DESCRIPTION
+
+    This program is designed primarily to make your X windows interface more
+    obfuscated. Try doing something mouse driven (such as using a mouse
+    driven editor on this program) whilst it is running. If you're not sure
+    what it does, looking at the code should give a fair idea.
+
+
+OPTIONS
+    
+    It only takes one optional option: the greasiness factor. This is the
+    number that the speed is divided by on each iteration. The default is
+    1.03. A setting of 1 (no friction is fun), as is 0.99. 
+
+    Being an X program, it recognised the DISPLAY variable.
+
+
+PORTABILITY
+
+    The program is very portable, even to non X architectures. All that is
+    required is a large desk and some good grease.
+
+
+
+COMMENTS
+
+    It is really rather surprising that code like this should not only be
+    portable, but compile with almost no warnings on most of the compilers
+    tested. It's a kind of shame that none of the compilers do anything like
+    this:
+
+    $make greasymouse
+    cc greasymouse.c -o greasymouse -lX11
+    greasymouse.c:30: This macro should have more text and spaces in it
+    greasymouse.c:32: This is a really stupid way to perform this operation
+    greasymouse.c:42: This program would look better with a newline here
+    greasymouse.c:48: That's a really silly thing to do
+    greasymouse.c:55: So is that
+    ...
+    greasymouse.c:58: This program is rubbish. I'm not going to link it.
+    $
+
+
+            The code is best viewed with tabstops every 8 spaces.
+
+
+BUGS
+
+    The mouse gets stuck completely if you give it an option of less than 1
+    and leave it for too long. This is quite annoying if it didn't leave the
+    terminal if was run from in focus. 
+
+    It gets very jerky if the processor is being used. There are better time
+    functions than clock() but I haven't used them.
+
+    It deflects slightly when it gets very slow.
+
+    It annoys other people if you run it on their display too often. Maybe I
+    should make future versions print funny jokes to keep the humor fresh.
+
+    It's pretty ropey over a 56K modem.
+
+    It's even ropier over a 56K modem and tunneled through 3 ssh links.
+
+
+
+WARNINGS
+
+    Pages and pages and pages of things, with GCC at any rate.
+
+    It suggests loads of ()'s where they're not needed.
+
+    It reckons I have not used some of the values I have computed. I would
+    never do a thing like that: I just haven't used them in the way it's
+    used to.
+
+    
+
+    The MIPS compiler suggests an == instead of an = in expressions such as
+        &&(a=b)
+    but I its suggestions would break my program.
+    It also reckons that r() has no prototype.
+
+    Giving the -pedantic option to the MIPS compiler causes it to generate
+    warnings about its own header files, but not any extra ones with this
+    program.
+
+
+
+    With all warnings enabled, the DEC compiler, oddly enough finds some
+    problems with its own include files, but none with my program.
+
+
+ERRORS
+    
+    The DEC compiler of this version:    
+
+    DEC C V5.6-079 on Digital UNIX V4.0 (Rev. 878)
+
+    can't compile the code. It thinks that preprocessor lines can not have
+    whitespace preceding the #. Moving the preprocessor directives to the
+    beginning of the line wrecks the layout but makes it compile.
+
+
+
@@ -452,8 +452,7 @@ FAQ on “<a href="../../faq.html#X11">X11</a>”.</p>
 <h3 id="bugs-and-misfeatures">Bugs and (Mis)features:</h3>
 <p>The current status of this entry is:</p>
 <blockquote>
-<p><strong>STATUS: INABIAF - please DO NOT fix</strong><br>
-<strong>STATUS: missing files - please provide them</strong><br></p>
+<p><strong>STATUS: INABIAF - please DO NOT fix</strong><br></p>
 </blockquote>
 <p>For more detailed information see <a href="../../bugs.html#2001_rosten">2001/rosten in bugs.html</a>.</p>
 <h2 id="to-use">To use:</h2>
@@ -479,7 +478,8 @@ cursor) in the wrong way. :-)</p>
 obfuscated. Try doing something mouse driven (such as using a mouse
 driven editor on this program) whilst it is running. If you’re not sure
 what it does, looking at the code should give a fair idea.</p>
-<p>It also has a [cat] man page if you want to install it as a ‘utility’.</p>
+<p>The file <a href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2001/rosten/greasymouse.man">greasymouse.man</a> is a cat
+man page if you want to install it as a ‘utility’.</p>
 <h3 id="options">OPTIONS</h3>
 <p>It only takes one optional option: the greasiness factor. This is the
 number that the speed is divided by on each iteration. The default is
@@ -565,6 +565,7 @@ beginning of the line wrecks the layout but makes it compile.</p>
 <li><a href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2001/rosten/rosten.c">rosten.c</a> - entry source code</li>
 <li><a href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2001/rosten/Makefile">Makefile</a> - entry Makefile</li>
 <li><a href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2001/rosten/rosten.orig.c">rosten.orig.c</a> - original source code</li>
+<li><a href="https://github.com/ioccc-src/temp-test-ioccc/blob/master/2001/rosten/greasymouse.man">greasymouse.man</a> - cat man page</li>
 </ul>
 <h2 id="secondary-files">Secondary files</h2>
 <ul>
@@ -2217,10 +2217,6 @@ provide enough args.</p>
 <h3 id="information-2001rostenindex.html">Information: <a href="2001/rosten/index.html">2001/rosten/index.html</a></h3>
 <p>See list of bugs <a href="2001/rosten/index.html#bugs">here</a>.</p>
 <p>Jump to: <a href="#">top</a></p>
-<h3 id="status-missing-files---please-provide-them-1">STATUS: missing files - please provide them</h3>
-<p>The author stated that there is a cat man page for this program in case one
-wanted to install it as a tool but this is missing.</p>
-<p>Jump to: <a href="#">top</a></p>
 <div id="2001_schweikh">
 <h2 id="schweikh">2001/schweikh</h2>
 </div>
@@ -2582,12 +2582,6 @@ See list of bugs [here](2001/rosten/index.html#bugs).

 Jump to: [top](#)

-### STATUS: missing files - please provide them
-
-The author stated that there is a cat man page for this program in case one
-wanted to install it as a tool but this is missing.
-
-Jump to: [top](#)

 <div id="2001_schweikh">
 ## 2001/schweikh