Add missing file in 2001/rosten

The new file, greasymouse.man, IS the cat man page noted by the author in their remarks. This file was provided by Leo as remark.txt but to make it render better I have made it a .man file and, for syntax highlighting, I moved the section titles to the first column of the file. I thought of making it a true man page but as the author suggested that it is a cat man page I decided against this.
2024-11-01 07:43:29 -07:00
1 parent e58bd97211
commit 8541a49291
@@ -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