code.delx.au - gnu-emacs/blob - lisp/play/bruce.el

   1 ;;; bruce.el --- bruce phrase utility for overloading the Communications -*- no-byte-compile: t -*-
   2 ;;; Decency Act snoops, if any.
   3
   4 ;; Copyright (C) 1988, 1993, 1997, 2001, 2002, 2003, 2004,
   5 ;;   2005, 2006, 2007, 2008, 2009, 2010, 2011, 2012 Free Software Foundation, Inc.
   6
   7 ;; Maintainer: FSF
   8 ;; Keywords: games
   9 ;; Created: Jan 1997
  10
  11 ;; This file is part of GNU Emacs.
  12
  13 ;; GNU Emacs is free software: you can redistribute it and/or modify
  14 ;; it under the terms of the GNU General Public License as published by
  15 ;; the Free Software Foundation, either version 3 of the License, or
  16 ;; (at your option) any later version.
  17
  18 ;; GNU Emacs is distributed in the hope that it will be useful,
  19 ;; but WITHOUT ANY WARRANTY; without even the implied warranty of
  20 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  21 ;; GNU General Public License for more details.
  22
  23 ;; You should have received a copy of the GNU General Public License
  24 ;; along with GNU Emacs.  If not, see <http://www.gnu.org/licenses/>.
  25
  26 ;;; Commentary:
  27
  28 ;; This program was written to protest the miss-named "Communications
  29 ;; Decency Act of 1996. This Act bans "indecent speech", whatever that is,
  30 ;; from the Internet. For more on the CDA, see Richard Stallman's essay on
  31 ;; censorship, included in the etc directory of emacs distributions 19.34
  32 ;; and up. See also http://www.eff.org/blueribbon.html.
  33
  34 ;; For many years, emacs has included a program called Spook. This program
  35 ;; adds a series of "keywords" to email just before it goes out. On the
  36 ;; theory that the NSA monitors people's email, the keywords would be
  37 ;; picked up by the NSA's snoop computers, causing them to waste time
  38 ;; reading your meeting schedule notices or other email boring to everyone
  39 ;; but you and (you hope) the recipient. See below (I left in the original
  40 ;; writeup when I made this conversion), or the emacs documentation at
  41 ;; ftp://prep.ai.mit.edu/pub/gnu/emacs-manual*.
  42
  43 ;; Bruce is a direct copy of spook, with the word "spook" replaced with
  44 ;; the word "bruce". Thanks to "esr", whoever he, she or it may be, this
  45 ;; conversion was an extremely easy piece of editing, suitable for a first
  46 ;; essay at elisp programming.
  47
  48 ;; You may think of the name as having been derived from a certain Monty
  49 ;; Python routine. Or from Lenny Bruce, who opposed censorship in his own
  50 ;; inimitable way. Bruce does exactly what Spook does: it throws keywords
  51 ;; into your email messages or other documents.
  52
  53 ;; However, in order to comply with the CDA as interpreted by Richard
  54 ;; Stallman (see the essay on censorship), bruce is distributed without a
  55 ;; data file from which to select words at random. Sorry about that. I
  56 ;; believe the average user will be able to come up with a few words on
  57 ;; his or her own. If that is a problem, feel free to ask any American
  58 ;; teenager, preferably one who attends a government school. Failing
  59 ;; that, you might write to Mr. Clinton or Ms Reno or their successors and
  60 ;; ask them for suggestions. Think of it as a public spirited act: the
  61 ;; time they spend answering you is time not spent persecuting someone
  62 ;; else. However, do ask them to respond by snail mail, where their
  63 ;; suggestions would be legal.
  64
  65 ;; To build the data file, just start a file called bruce.lines in the etc
  66 ;; directory of your emacs distribution. Note that each phrase or word has
  67 ;; to be followed by an ascii 0, control-@. See the file spook.lines in
  68 ;; the etc directory for an example. In emacs, use c-q c-@ to insert the
  69 ;; ascii 0s.
  70
  71 ;; Once you have edited up a data file, you have to tell emacs how to find
  72 ;; the program bruce. Add the following two lines to your .emacs file. Be
  73 ;; sure to uncomment the second line.
  74
  75 ;; for bruce mode
  76 ;; (autoload 'bruce "bruce" "Use the Bruce program to protest the CDA" t)
  77
  78 ;; Shut down emacs and fire it up again. Then "M-x bruce" should put some
  79 ;; shocking words in the current buffer.
  80
  81
  82 ;; Please note that I am not suggesting that you actually use this program
  83 ;; to add "illegal" words to your email, or any other purpose. First, you
  84 ;; don't really need a program to do it, and second, it would be illegal
  85 ;; for me to suggest or advise that you actually break the law. This
  86 ;; program was written as a demonstration only, and as an act of political
  87 ;; protest and free expression protected by the First Amendment, or
  88 ;; whatever is left of it.
  89
  90
  91 ;; We now return to the original writeup for spook:
  92
  93 ;; Steve Strassmann <straz@media-lab.media.mit.edu> didn't write the
  94 ;; program spook, from which this was adapted, and even if he did, he
  95 ;; really didn't mean for you to use it in an anarchistic way.
  96 ;;
  97 ;; To use this:
  98 ;;  Just before sending mail, do M-x spook.
  99 ;;  A number of phrases will be inserted into your buffer, to help
 100 ;;  give your message that extra bit of attractiveness for automated
 101 ;;  keyword scanners.  Help defeat the NSA trunk trawler!
 102
 103 ;;; Code:
 104
 105 (require 'cookie1)
 106
 107 ; Variables
 108 (defgroup bruce nil
 109   "Insert phrases selected at random from a file into a buffer."
 110   :prefix "bruce-"
 111   :group 'games)
 112
 113 (defcustom bruce-phrases-file "~/bruce.lines"
 114   "Keep your favourite phrases here."
 115   :type 'file
 116   :group 'bruce)
 117
 118 (defcustom bruce-phrase-default-count 15
 119   "Default number of phrases to insert."
 120   :type 'integer
 121   :group 'bruce)
 122
 123 ;;;###autoload
 124 (defun bruce ()
 125   "Adds that special touch of class to your outgoing mail."
 126   (interactive)
 127   (or (file-exists-p bruce-phrases-file)
 128       (error "You need to create %s" bruce-phrases-file))
 129   (cookie-insert bruce-phrases-file
 130                  bruce-phrase-default-count
 131                  "Checking authorization..."
 132                  "Checking authorization...Approved"))
 133
 134 ;;;###autoload
 135 (defun snarf-bruces ()
 136   "Return a vector containing the lines from `bruce-phrases-file'."
 137   (or (file-exists-p bruce-phrases-file)
 138       (error "You need to create %s" bruce-phrases-file))
 139   (cookie-snarf bruce-phrases-file
 140                 "Checking authorization..."
 141                 "Checking authorization...Approved"))
 142
 143 ;; Note: the implementation that used to take up most of this file has been
 144 ;; cleaned up, generalized, gratuitously broken by esr, and now resides in
 145 ;; cookie1.el.
 146
 147 (provide 'bruce)
 148
 149 ;; arch-tag: b83ded51-4ccb-41ef-8bd6-3b521e81dd9b
 150 ;;; bruce.el ends here