From 8541a4929176776118bb2abfbf4a37340a2d5990 Mon Sep 17 00:00:00 2001 From: Cody Boone Ferguson <53008573+xexyl@users.noreply.github.com> Date: Fri, 1 Nov 2024 07:25:01 -0700 Subject: [PATCH] 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. --- 2001/rosten/.entry.json | 8 +++ 2001/rosten/README.md | 4 +- 2001/rosten/greasymouse.man | 115 ++++++++++++++++++++++++++++++++++++ 2001/rosten/index.html | 7 ++- bugs.html | 4 -- bugs.md | 6 -- 6 files changed, 129 insertions(+), 15 deletions(-) create mode 100644 2001/rosten/greasymouse.man diff --git a/2001/rosten/.entry.json b/2001/rosten/.entry.json index 0251b287a..de5dc9142 100644 --- a/2001/rosten/.entry.json +++ b/2001/rosten/.entry.json @@ -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, diff --git a/2001/rosten/README.md b/2001/rosten/README.md index 79015b79c..0ae207ad5 100644 --- a/2001/rosten/README.md +++ b/2001/rosten/README.md @@ -14,7 +14,6 @@ FAQ on "[X11](../../faq.html#X11)". The current status of this entry is: > **STATUS: INABIAF - please DO NOT fix**
-> **STATUS: missing files - please provide them**
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 diff --git a/2001/rosten/greasymouse.man b/2001/rosten/greasymouse.man new file mode 100644 index 000000000..da8492186 --- /dev/null +++ b/2001/rosten/greasymouse.man @@ -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. + + + diff --git a/2001/rosten/index.html b/2001/rosten/index.html index f51bd4d15..680027815 100644 --- a/2001/rosten/index.html +++ b/2001/rosten/index.html @@ -452,8 +452,7 @@ FAQ on “X11”.

Bugs and (Mis)features:

The current status of this entry is:

-

STATUS: INABIAF - please DO NOT fix
-STATUS: missing files - please provide them

+

STATUS: INABIAF - please DO NOT fix

For more detailed information see 2001/rosten in bugs.html.

To use:

@@ -479,7 +478,8 @@ cursor) in the wrong way. :-)

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 is a cat +man page if you want to install it as a ‘utility’.

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 @@ -565,6 +565,7 @@ beginning of the line wrecks the layout but makes it compile.

  • rosten.c - entry source code
  • Makefile - entry Makefile
  • rosten.orig.c - original source code
    • +
  • greasymouse.man - cat man page

    • Secondary files