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