erc 96 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309131013111312131313141315131613171318131913201321132213231324132513261327132813291330133113321333133413351336133713381339134013411342134313441345134613471348134913501351135213531354135513561357135813591360136113621363136413651366136713681369137013711372137313741375137613771378137913801381138213831384138513861387138813891390139113921393139413951396139713981399140014011402140314041405140614071408140914101411141214131414141514161417141814191420142114221423142414251426142714281429143014311432143314341435143614371438143914401441144214431444144514461447144814491450145114521453145414551456145714581459146014611462146314641465146614671468146914701471147214731474147514761477147814791480148114821483148414851486148714881489149014911492149314941495149614971498149915001501150215031504150515061507150815091510151115121513151415151516151715181519152015211522152315241525152615271528152915301531153215331534153515361537153815391540154115421543154415451546154715481549155015511552155315541555155615571558155915601561156215631564156515661567156815691570157115721573157415751576157715781579158015811582158315841585158615871588158915901591159215931594159515961597159815991600160116021603160416051606160716081609161016111612161316141615161616171618161916201621162216231624162516261627162816291630163116321633163416351636163716381639164016411642164316441645164616471648164916501651165216531654165516561657165816591660166116621663166416651666166716681669167016711672167316741675167616771678167916801681168216831684168516861687168816891690169116921693169416951696169716981699170017011702170317041705170617071708170917101711171217131714171517161717171817191720172117221723172417251726172717281729173017311732173317341735173617371738173917401741174217431744174517461747174817491750175117521753175417551756175717581759176017611762176317641765176617671768176917701771177217731774177517761777177817791780178117821783178417851786178717881789179017911792179317941795179617971798179918001801180218031804180518061807180818091810181118121813181418151816181718181819182018211822182318241825182618271828182918301831183218331834183518361837183818391840184118421843184418451846184718481849185018511852185318541855185618571858185918601861186218631864186518661867186818691870187118721873187418751876187718781879188018811882188318841885188618871888188918901891189218931894189518961897189818991900190119021903190419051906190719081909191019111912191319141915191619171918191919201921192219231924192519261927192819291930193119321933193419351936193719381939194019411942194319441945194619471948194919501951195219531954195519561957195819591960196119621963196419651966196719681969197019711972197319741975197619771978197919801981198219831984198519861987198819891990199119921993199419951996199719981999200020012002200320042005200620072008200920102011201220132014201520162017201820192020202120222023202420252026202720282029203020312032203320342035203620372038203920402041204220432044204520462047204820492050205120522053205420552056205720582059206020612062206320642065206620672068206920702071207220732074207520762077207820792080208120822083208420852086208720882089209020912092209320942095209620972098209921002101210221032104210521062107210821092110211121122113211421152116211721182119212021212122212321242125212621272128212921302131213221332134213521362137213821392140214121422143214421452146214721482149215021512152215321542155215621572158215921602161216221632164216521662167216821692170217121722173217421752176217721782179218021812182218321842185218621872188218921902191219221932194219521962197219821992200220122022203220422052206220722082209221022112212221322142215221622172218221922202221222222232224222522262227222822292230223122322233223422352236223722382239224022412242224322442245224622472248224922502251225222532254225522562257225822592260226122622263226422652266226722682269227022712272227322742275227622772278227922802281
  1. This is ../../info/erc, produced by makeinfo version 4.13 from erc.texi.
  2. This manual is for ERC version 5.3.
  3. Copyright (C) 2005-2012 Free Software Foundation, Inc.
  4. Permission is granted to copy, distribute and/or modify this
  5. document under the terms of the GNU Free Documentation License,
  6. Version 1.3 or any later version published by the Free Software
  7. Foundation; with no Invariant Sections, with the Front-Cover texts
  8. being "A GNU Manual," and with the Back-Cover Texts as in (a)
  9. below. A copy of the license is included in the section entitled
  10. "GNU Free Documentation License".
  11. (a) The FSF's Back-Cover Text is: "You have the freedom to copy and
  12. modify this GNU manual. Buying copies from the FSF supports it in
  13. developing GNU and promoting software freedom."
  14. All Emacs Lisp code contained in this document may be used,
  15. distributed, and modified without restriction.
  16. INFO-DIR-SECTION Emacs network features
  17. START-INFO-DIR-ENTRY
  18. * ERC: (erc). Powerful and extensible IRC client for Emacs.
  19. END-INFO-DIR-ENTRY
  20. 
  21. File: erc, Node: Top, Next: Introduction, Prev: (dir), Up: (dir)
  22. ERC
  23. ***
  24. This manual is for ERC version 5.3.
  25. Copyright (C) 2005-2012 Free Software Foundation, Inc.
  26. Permission is granted to copy, distribute and/or modify this
  27. document under the terms of the GNU Free Documentation License,
  28. Version 1.3 or any later version published by the Free Software
  29. Foundation; with no Invariant Sections, with the Front-Cover texts
  30. being "A GNU Manual," and with the Back-Cover Texts as in (a)
  31. below. A copy of the license is included in the section entitled
  32. "GNU Free Documentation License".
  33. (a) The FSF's Back-Cover Text is: "You have the freedom to copy and
  34. modify this GNU manual. Buying copies from the FSF supports it in
  35. developing GNU and promoting software freedom."
  36. All Emacs Lisp code contained in this document may be used,
  37. distributed, and modified without restriction.
  38. * Menu:
  39. * Introduction:: What is ERC?
  40. * Obtaining ERC:: How to get ERC releases and development
  41. versions.
  42. * Installation:: Compiling and installing ERC.
  43. * Getting Started:: Quick Start guide to using ERC.
  44. * Keystroke Summary:: Keystrokes used in ERC buffers.
  45. * Modules:: Available modules for ERC.
  46. * Advanced Usage:: Cool ways of using ERC.
  47. * Getting Help and Reporting Bugs::
  48. * History:: The history of ERC.
  49. * Copying:: The GNU General Public License gives you
  50. permission to redistribute ERC on
  51. certain terms; it also explains that
  52. there is no warranty.
  53. * GNU Free Documentation License:: The license for this documentation.
  54. * Concept Index:: Search for terms.
  55. --- The Detailed Node Listing ---
  56. Obtaining ERC
  57. * Releases:: Released versions of ERC.
  58. * Development:: Latest unreleased development changes.
  59. Getting Started
  60. * Sample Session:: Example of connecting to the #emacs channel
  61. * Special Features:: Differences from standalone IRC clients
  62. Advanced Usage
  63. * Connecting:: Ways of connecting to an IRC server.
  64. * Sample Configuration:: An example configuration file.
  65. * Options:: Options that are available for ERC.
  66. 
  67. File: erc, Node: Introduction, Next: Obtaining ERC, Prev: Top, Up: Top
  68. 1 Introduction
  69. **************
  70. ERC is a powerful, modular, and extensible IRC client for Emacs.
  71. It comes with the following capabilities enabled by default.
  72. * Flood control
  73. * Timestamps
  74. * Join channels automatically
  75. * Buttonize URLs, nicknames, and other text
  76. * Wrap long lines
  77. * Highlight or remove IRC control characters
  78. * Highlight pals, fools, and other keywords
  79. * Detect netsplits
  80. * Complete nicknames and commands in a programmable fashion
  81. * Make displayed lines read-only
  82. * Input history
  83. * Track channel activity in the mode-line
  84. 
  85. File: erc, Node: Obtaining ERC, Next: Installation, Prev: Introduction, Up: Top
  86. 2 Obtaining ERC
  87. ***************
  88. * Menu:
  89. * Releases:: Released versions of ERC.
  90. * Development:: Latest unreleased development changes.
  91. Note that some ERC files are not included with Emacs due to
  92. copyright or dependency issues. If desired, they may be found at the
  93. following locations, or from your local GNU mirror.
  94. * `http://ftp.gnu.org/gnu/erc/erc-5.3-extras.tar.gz'
  95. * `http://ftp.gnu.org/gnu/erc/erc-5.3-extras.zip'
  96. The rest of this chapter may be skipped if you are using the version
  97. of ERC that comes with Emacs.
  98. 
  99. File: erc, Node: Releases, Next: Development, Prev: Obtaining ERC, Up: Obtaining ERC
  100. 2.1 Releases
  101. ============
  102. Choose to install a release if you want to minimize risk.
  103. Errors are corrected in development first. User-visible changes
  104. will be announced on the <erc-discuss@gnu.org> mailing list. *note
  105. Getting Help and Reporting Bugs::.
  106. Debian users can get ERC via apt-get. The `erc' package is
  107. available in the official Debian repository.
  108. Alternatively, you can download the latest release from
  109. `http://ftp.gnu.org/gnu/erc', or your local GNU mirror.
  110. 
  111. File: erc, Node: Development, Prev: Releases, Up: Obtaining ERC
  112. 2.2 Development
  113. ===============
  114. Choose the development version if you want to live on the bleeding edge
  115. of ERC development or try out new features before release.
  116. The git version control system allows you to keep up-to-date with the
  117. latest changes to the development version of ERC. It also allows you
  118. to contribute changes (via commits, if you are have developer access to
  119. the repository, or via patches, otherwise). If you would like to
  120. contribute to ERC development, it is highly recommended that you use
  121. git.
  122. If you are new to git, you might find this tutorial helpful:
  123. `http://www.kernel.org/pub/software/scm/git/docs/gittutorial.html'.
  124. Downloading ERC with git and staying up-to-date involves the
  125. following steps.
  126. 1. Install git.
  127. * Debian and Ubuntu: `apt-get install git-core'.
  128. * Windows: `http://git.or.cz/gitwiki/WindowsInstall'.
  129. * Other operating systems: download, compile, and install the
  130. source from `http://www.kernel.org/pub/software/scm/git/', or
  131. find a git package for your operating system.
  132. 2. Download the ERC development branch.
  133. If you have developer access to ERC, do:
  134. git clone ssh://loginname@git.sv.gnu.org/srv/git/erc.git
  135. otherwise, do:
  136. git clone git://git.sv.gnu.org/erc.git
  137. If you are behind a restrictive firewall, and do not have developer
  138. access, then do the following instead:
  139. git clone http://git.sv.gnu.org/r/erc.git
  140. 3. List upstream changes that are missing from your local copy. Do
  141. this whenever you want to see whether new changes have been
  142. committed to ERC. If you wish, you may skip this step and proceed
  143. directly to the "update" step.
  144. # Change to the source directory you are interested in.
  145. cd erc
  146. # Fetch new changes from the repository, but don't apply them yet
  147. git fetch origin
  148. # Display log messages for the new changes
  149. git log HEAD..origin
  150. "origin" is git's name for the location where you originally got
  151. ERC from. You can change this location at any time by editing the
  152. `.git/config' file in the directory where the ERC source was
  153. placed.
  154. 4. Update to the latest version by pulling in any missing changes.
  155. cd erc
  156. git pull origin
  157. git will show how many files changed, and will provide a visual
  158. display for how many lines were changed in each file.
  159. There are other ways to interact with the ERC repository.
  160. * Browse git repo: `http://git.sv.gnu.org/gitweb/?p=erc.git'
  161. * Latest development snapshot:
  162. `http://mwolson.org/static/dist/erc-latest.tar.gz'
  163. * Latest development snapshot (zip file):
  164. `http://mwolson.org/static/dist/erc-latest.zip'
  165. The latest development snapshot can lag behind the git repo by as
  166. much as 20 minutes, but never more than that.
  167. For further information on committing changes to ERC and performing
  168. development, please consult
  169. `http://emacswiki.org/cgi-bin/wiki/ErcDevelopment'.
  170. 
  171. File: erc, Node: Installation, Next: Getting Started, Prev: Obtaining ERC, Up: Top
  172. 3 Installation
  173. **************
  174. ERC may be compiled and installed on your machine.
  175. This section may be skipped if you are using the version of ERC that
  176. comes with Emacs.
  177. Compilation
  178. ...........
  179. This is an optional step, since Emacs Lisp source code does not
  180. necessarily have to be byte-compiled. It will yield a speed increase,
  181. though.
  182. A working copy of Emacs or XEmacs is needed in order to compile ERC.
  183. By default, the program that is installed with the name `emacs' will be
  184. used.
  185. If you want to use the `xemacs' binary to perform the compilation,
  186. you would need to edit `Makefile' in the top-level directory as
  187. follows. You can put either a full path to an Emacs or XEmacs binary
  188. or just the command name, as long as it is in the `PATH'.
  189. EMACS = xemacs
  190. SITEFLAG = -no-site-file
  191. Running `make' should compile the ERC source files in the `lisp'
  192. directory.
  193. Installation
  194. ............
  195. ERC may be installed into your file hierarchy by doing the following.
  196. Edit the `Makefile' file so that `ELISPDIR' points to where you want
  197. the source and compiled ERC files to be installed and `INFODIR'
  198. indicates where to put the ERC manual. Of course, you will want to
  199. edit `EMACS' and `SITEFLAG' as shown in the Compilation section if you
  200. are using XEmacs.
  201. If you are installing ERC on a Debian system, you might want to
  202. change the value of `INSTALLINFO' as specified in `Makefile'.
  203. Run `make' as a normal user.
  204. Run `make install' as the root user if you have chosen installation
  205. locations that require this.
  206. 
  207. File: erc, Node: Getting Started, Next: Keystroke Summary, Prev: Installation, Up: Top
  208. 4 Getting Started
  209. *****************
  210. To use ERC, add the directory containing its files to your `load-path'
  211. variable, in your `.emacs' file. Then, load ERC itself. An example
  212. follows.
  213. (require 'erc)
  214. Once ERC is loaded, the command `M-x erc' will start ERC and prompt
  215. for the server to connect to.
  216. If you want to place ERC settings in their own file, you can place
  217. them in `~/.emacs.d/.ercrc.el', creating it if necessary.
  218. If you would rather use the Customize interface to change how ERC
  219. works, do `M-x customize-group RET erc RET'. In particular, ERC comes
  220. with lots of modules that may be enabled or disabled; to select which
  221. ones you want, do `M-x customize-variable RET erc-modules RET'.
  222. * Menu:
  223. * Sample Session:: Example of connecting to the #emacs channel
  224. * Special Features:: Differences from standalone IRC clients
  225. 
  226. File: erc, Node: Sample Session, Next: Special Features, Prev: Getting Started, Up: Getting Started
  227. 4.1 Sample Session
  228. ==================
  229. This is an example ERC session which shows how to connect to the #emacs
  230. channel on Freenode. Another IRC channel on Freenode that may be of
  231. interest is #erc, which is a channel where ERC users and developers hang
  232. out.
  233. * Connect to Freenode
  234. Run `M-x erc'. Use "irc.freenode.net" as the IRC server, "6667"
  235. as the port, and choose a nickname.
  236. * Get used to the interface
  237. Switch to the "irc.freenode.net:6667" buffer, if you're not already
  238. there. You will see first some messages about checking for ident,
  239. and then a bunch of other messages that describe the current IRC
  240. server.
  241. * Join the #emacs channel
  242. In that buffer, type "/join SPC #emacs" and hit `RET'. Depending
  243. on how you've set up ERC, either a new buffer for "#emacs" will be
  244. displayed, or a new buffer called "#emacs" will be created in the
  245. background. If the latter, switch to the "#emacs" buffer. You
  246. will see the channel topic and a list of the people who are
  247. currently on the channel.
  248. * Register your nickname with Freenode
  249. If you would like to be able to talk with people privately on the
  250. Freenode network, you will have to "register" your nickname. To do
  251. so, switch to the "irc.freenode.net:6667" buffer and type "/msg
  252. NickServ register <password>", replacing "<password>" with your
  253. desired password. It should tell you that the operation was
  254. successful.
  255. * Talk to people in the channel
  256. If you switch back to the "#emacs" buffer, you can type a message,
  257. and everyone on the channel will see it.
  258. * Open a query buffer to talk to someone
  259. If you want to talk with someone in private (this should usually
  260. not be done for technical help, only for personal questions), type
  261. "/query <nick>", replacing "<nick>" with the nickname of the
  262. person you would like to talk to. Depending on how ERC is set up,
  263. you will either see a new buffer with the name of the person, or
  264. such a buffer will be created in the background and you will have
  265. to switch to it. Begin typing messages, and you will be able to
  266. have a conversation.
  267. Note that if the other person is not registered, you will not be
  268. able to talk with them.
  269. 
  270. File: erc, Node: Special Features, Prev: Sample Session, Up: Getting Started
  271. 4.2 Special Features
  272. ====================
  273. ERC has some features that distinguish it from some IRC clients.
  274. * multiple channels and multiple servers
  275. Every channel is put in a separate buffer. Several IRC servers
  276. may be connected to at the same time.
  277. * private message separation
  278. Private conversations are treated as channels, and are put into
  279. separate buffers in Emacs. We call these "query buffers".
  280. * highlighting
  281. Some occurrences of words can be highlighted, which makes it
  282. easier to track different kinds of conversations.
  283. * notification
  284. ERC can notify you that certain users are online.
  285. * channel tracking
  286. Channels can be hidden and conversation continue in the
  287. background. You are notified when something is said in such a
  288. channel that is not currently visible. This makes it easy to get
  289. Real Work done while still maintaining an IRC presence.
  290. * nick completion
  291. ERC can complete words upon hitting `TAB', which eases the writing
  292. of nicknames in messages.
  293. * history
  294. Past actions are kept in history rings for future use. To
  295. navigate a history ring, hit `M-p' to go backwards and `M-n' to go
  296. forwards.
  297. * multiple languages
  298. Different channels and servers may have different language
  299. encodings.
  300. In addition, it is possible to translate the messages that ERC
  301. uses into multiple languages. Please contact the developers of
  302. ERC at <erc-discuss@gnu.org> if you are interested in helping with
  303. the translation effort.
  304. * user scripting
  305. Users can load scripts (e.g. auto greeting scripts) when ERC
  306. starts up.
  307. It is also possible to make custom IRC commands, if you know a
  308. little Emacs Lisp. Just make an Emacs Lisp function and call it
  309. `erc-cmd-NEWCOMMAND', where `NEWCOMMAND' is the name of the new
  310. command in capital letters.
  311. * auto reconnect
  312. If the connection goes away at some point, ERC will try to
  313. reconnect automatically. If it fails to reconnect, and you want
  314. to try to manually reestablish the connection at some later point,
  315. switch to an ERC buffer and run the `/RECONNECT' command.
  316. 
  317. File: erc, Node: Keystroke Summary, Next: Modules, Prev: Getting Started, Up: Top
  318. 5 Keys Used in ERC
  319. ******************
  320. This is a summary of keystrokes available in every ERC buffer.
  321. `C-a or <home> (`erc-bol')'
  322. Go to beginning of line or end of prompt.
  323. `RET (`erc-send-current-line')'
  324. Send the current line
  325. `TAB (`erc-complete-word')'
  326. If at prompt, complete the current word. Otherwise, move to the
  327. next link or button.
  328. `M-TAB (`ispell-complete-word')'
  329. Complete the given word, using ispell.
  330. `C-c C-a (`erc-bol')'
  331. Go to beginning of line or end of prompt.
  332. `C-c C-b (`erc-iswitchb')'
  333. Use `iswitchb-read-buffer' to prompt for a ERC buffer to switch to.
  334. `C-c C-c (`erc-toggle-interpret-controls')'
  335. Toggle interpretation of control sequences in messages.
  336. `C-c C-d (`erc-input-action')'
  337. Interactively input a user action and send it to IRC.
  338. `C-c C-e (`erc-toggle-ctcp-autoresponse')'
  339. Toggle automatic CTCP replies (like VERSION and PING).
  340. `C-c C-f (`erc-toggle-flood-control')'
  341. Toggle use of flood control on sent messages.
  342. `C-c TAB (`erc-invite-only-mode')'
  343. Turn on the invite only mode (+i) for the current channel.
  344. `C-c C-j (`erc-join-channel')'
  345. Join channel. If point is at the beginning of a channel name, use
  346. that as default.
  347. `C-c C-k (`erc-go-to-log-matches-buffer')'
  348. Interactively open an erc-log-matches buffer
  349. `C-c C-l (`erc-save-buffer-in-logs')'
  350. Append buffer contents to the log file, if logging is enabled.
  351. `C-c C-n (`erc-channel-names')'
  352. Run "/names #channel" in the current channel.
  353. `C-c C-o (`erc-get-channel-mode-from-keypress')'
  354. Read a key sequence and call the corresponding channel mode
  355. function. After doing `C-c C-o', type in a channel mode letter.
  356. `C-g' means quit. `RET' lets you type more than one mode at a
  357. time. If `l' is pressed, `erc-set-channel-limit' gets called. If
  358. `k' is pressed, `erc-set-channel-key' gets called. Anything else
  359. will be sent to `erc-toggle-channel-mode'.
  360. `C-c C-p (`erc-part-from-channel')'
  361. Part from the current channel and prompt for a reason.
  362. `C-c C-q (`erc-quit-server')'
  363. Disconnect from current server after prompting for reason.
  364. `C-c C-r (`erc-remove-text-properties-region')'
  365. Clears the region (start,end) in object from all colors, etc.
  366. `C-c C-t (`erc-set-topic')'
  367. Prompt for a topic for the current channel.
  368. `C-c C-u (`erc-kill-input')'
  369. Kill current input line using `erc-bol' followed by `kill-line'.
  370. 
  371. File: erc, Node: Modules, Next: Advanced Usage, Prev: Keystroke Summary, Up: Top
  372. 6 Modules
  373. *********
  374. One way to add functionality to ERC is to customize which of its many
  375. modules are loaded.
  376. There is a spiffy customize interface, which may be reached by typing
  377. `M-x customize-option erc-modules RET'. Alternatively, set
  378. `erc-modules' manually and then call `erc-update-modules'.
  379. The following is a list of available modules.
  380. `autoaway'
  381. Set away status automatically
  382. `autojoin'
  383. Join channels automatically
  384. `bbdb'
  385. Integrate with the Big Brother Database
  386. `button'
  387. Buttonize URLs, nicknames, and other text
  388. `capab-identify'
  389. Mark unidentified users on freenode and other servers supporting
  390. CAPAB.
  391. `completion (aka pcomplete)'
  392. Complete nicknames and commands (programmable)
  393. `fill'
  394. Wrap long lines
  395. `hecomplete'
  396. Complete nicknames and commands (old). This is the old module--you
  397. might prefer the "completion" module instead.
  398. `identd'
  399. Launch an identd server on port 8113
  400. `irccontrols'
  401. Highlight or remove IRC control characters
  402. `log'
  403. Save buffers in logs
  404. `match'
  405. Highlight pals, fools, and other keywords
  406. `menu'
  407. Display a menu in ERC buffers
  408. `netsplit'
  409. Detect netsplits
  410. `noncommands'
  411. Don't display non-IRC commands after evaluation
  412. `notify'
  413. Notify when the online status of certain users changes
  414. `page'
  415. Process CTCP PAGE requests from IRC
  416. `readonly'
  417. Make displayed lines read-only
  418. `replace'
  419. Replace text in messages
  420. `ring'
  421. Enable an input history
  422. `scrolltobottom'
  423. Scroll to the bottom of the buffer
  424. `services'
  425. Identify to Nickserv (IRC Services) automatically
  426. `smiley'
  427. Convert smileys to pretty icons
  428. `sound'
  429. Play sounds when you receive CTCP SOUND requests
  430. `spelling'
  431. Check spelling of messages
  432. `stamp'
  433. Add timestamps to messages
  434. `track'
  435. Track channel activity in the mode-line
  436. `truncate'
  437. Truncate buffers to a certain size
  438. `unmorse'
  439. Translate morse code in messages
  440. 
  441. File: erc, Node: Advanced Usage, Next: Getting Help and Reporting Bugs, Prev: Modules, Up: Top
  442. 7 Advanced Usage
  443. ****************
  444. * Menu:
  445. * Connecting:: Ways of connecting to an IRC server.
  446. * Sample Configuration:: An example configuration file.
  447. * Options:: Options that are available for ERC.
  448. 
  449. File: erc, Node: Connecting, Next: Sample Configuration, Prev: Advanced Usage, Up: Advanced Usage
  450. 7.1 Connecting to an IRC Server
  451. ===============================
  452. The easiest way to connect to an IRC server is to call `M-x erc'. If
  453. you want to assign this function to a keystroke, the following will
  454. help you figure out its parameters.
  455. -- Function: erc
  456. Select connection parameters and run ERC. Non-interactively, it
  457. takes the following keyword arguments.
  458. * SERVER
  459. * PORT
  460. * NICK
  461. * PASSWORD
  462. * FULL-NAME
  463. That is, if called with the following arguments, SERVER and
  464. FULL-NAME will be set to those values, whereas `erc-compute-port',
  465. `erc-compute-nick' and `erc-compute-full-name' will be invoked for
  466. the values of the other parameters.
  467. (erc :server "irc.freenode.net" :full-name "Harry S Truman")
  468. Server
  469. ------
  470. -- Function: erc-compute-server &optional server
  471. Return an IRC server name.
  472. This tries a number of increasingly more default methods until a
  473. non-nil value is found.
  474. * SERVER (the argument passed to this function)
  475. * The `erc-server' option
  476. * The value of the IRCSERVER environment variable
  477. * The `erc-default-server' variable
  478. -- User Option: erc-server nil
  479. IRC server to use if one is not provided.
  480. Port
  481. ----
  482. -- Function: erc-compute-port &optional port
  483. Return a port for an IRC server.
  484. This tries a number of increasingly more default methods until a
  485. non-nil value is found.
  486. * PORT (the argument passed to this function)
  487. * The `erc-port' option
  488. * The `erc-default-port' variable
  489. -- User Option: erc-port
  490. IRC port to use if not specified.
  491. This can be either a string or a number.
  492. Nick
  493. ----
  494. -- Function: erc-compute-nick &optional nick
  495. Return user's IRC nick.
  496. This tries a number of increasingly more default methods until a
  497. non-nil value is found.
  498. * NICK (the argument passed to this function)
  499. * The `erc-nick' option
  500. * The value of the IRCNICK environment variable
  501. * The result from the `user-login-name' function
  502. -- User Option: erc-nick
  503. Nickname to use if one is not provided.
  504. This can be either a string, or a list of strings. In the latter
  505. case, if the first nick in the list is already in use, other nicks
  506. are tried in the list order.
  507. -- User Option: erc-nick-uniquifier
  508. The string to append to the nick if it is already in use.
  509. -- User Option: erc-try-new-nick-p
  510. If the nickname you chose isn't available, and this option is
  511. non-nil, ERC should automatically attempt to connect with another
  512. nickname.
  513. You can manually set another nickname with the /NICK command.
  514. Full name
  515. ---------
  516. -- Function: erc-compute-full-name &optional full-name
  517. Return user's full name.
  518. This tries a number of increasingly more default methods until a
  519. non-nil value is found.
  520. * FULL-NAME (the argument passed to this function)
  521. * The `erc-user-full-name' option
  522. * The value of the IRCNAME environment variable
  523. * The result from the `user-full-name' function
  524. -- User Option: erc-user-full-name
  525. User full name.
  526. This can be either a string or a function to call.
  527. 
  528. File: erc, Node: Sample Configuration, Next: Options, Prev: Connecting, Up: Advanced Usage
  529. 7.2 Sample Configuration
  530. ========================
  531. Here is an example of configuration settings for ERC. This can go into
  532. your Emacs configuration file. Everything after the `(require 'erc)'
  533. command can optionally go into `~/.emacs.d/.ercrc.el'.
  534. ;;; Sample ERC configuration
  535. ;; Add the ERC directory to load path -- you don't need this if you are
  536. ;; using the version of ERC that comes with Emacs
  537. (add-to-list 'load-path "~/elisp/erc")
  538. ;; Load ERC
  539. (require 'erc)
  540. ;; Load authentication info from an external source. Put sensitive
  541. ;; passwords and the like in here.
  542. (load "~/.emacs.d/.erc-auth")
  543. ;; This is an example of how to make a new command. Type "/uptime" to
  544. ;; use it.
  545. (defun erc-cmd-UPTIME (&rest ignore)
  546. "Display the uptime of the system, as well as some load-related
  547. stuff, to the current ERC buffer."
  548. (let ((uname-output
  549. (replace-regexp-in-string
  550. ", load average: " "] {Load average} ["
  551. ;; Collapse spaces, remove
  552. (replace-regexp-in-string
  553. " +" " "
  554. ;; Remove beginning and trailing whitespace
  555. (replace-regexp-in-string
  556. "^ +\\|[ \n]+$" ""
  557. (shell-command-to-string "uptime"))))))
  558. (erc-send-message
  559. (concat "{Uptime} [" uname-output "]"))))
  560. ;; This causes ERC to connect to the Freenode network upon hitting
  561. ;; C-c e f. Replace MYNICK with your IRC nick.
  562. (global-set-key "\C-cef" (lambda () (interactive)
  563. (erc :server "irc.freenode.net" :port "6667"
  564. :nick "MYNICK")))
  565. ;; This causes ERC to connect to the IRC server on your own machine (if
  566. ;; you have one) upon hitting C-c e b. Replace MYNICK with your IRC
  567. ;; nick. Often, people like to run bitlbee (http://bitlbee.org/) as an
  568. ;; AIM/Jabber/MSN to IRC gateway, so that they can use ERC to chat with
  569. ;; people on those networks.
  570. (global-set-key "\C-ceb" (lambda () (interactive)
  571. (erc :server "localhost" :port "6667"
  572. :nick "MYNICK")))
  573. ;; Make C-c RET (or C-c C-RET) send messages instead of RET. This has
  574. ;; been commented out to avoid confusing new users.
  575. ;; (define-key erc-mode-map (kbd "RET") nil)
  576. ;; (define-key erc-mode-map (kbd "C-c RET") 'erc-send-current-line)
  577. ;; (define-key erc-mode-map (kbd "C-c C-RET") 'erc-send-current-line)
  578. ;;; Options
  579. ;; Join the #emacs and #erc channels whenever connecting to Freenode.
  580. (setq erc-autojoin-channels-alist '(("freenode.net" "#emacs" "#erc")))
  581. ;; Interpret mIRC-style color commands in IRC chats
  582. (setq erc-interpret-mirc-color t)
  583. ;; The following are commented out by default, but users of other
  584. ;; non-Emacs IRC clients might find them useful.
  585. ;; Kill buffers for channels after /part
  586. ;; (setq erc-kill-buffer-on-part t)
  587. ;; Kill buffers for private queries after quitting the server
  588. ;; (setq erc-kill-queries-on-quit t)
  589. ;; Kill buffers for server messages after quitting the server
  590. ;; (setq erc-kill-server-buffer-on-quit t)
  591. 
  592. File: erc, Node: Options, Prev: Sample Configuration, Up: Advanced Usage
  593. 7.3 Options
  594. ===========
  595. This section has not yet been written. For now, the easiest way to
  596. check out the available options for ERC is to do `M-x customize-group
  597. erc RET'.
  598. 
  599. File: erc, Node: Getting Help and Reporting Bugs, Next: History, Prev: Advanced Usage, Up: Top
  600. 8 Getting Help and Reporting Bugs
  601. *********************************
  602. After you have read this guide, if you still have questions about ERC,
  603. or if you have bugs to report, there are several places you can go.
  604. * `http://www.emacswiki.org/cgi-bin/wiki/ERC' is the emacswiki.org
  605. page for ERC. Anyone may add tips, hints, or bug descriptions to
  606. it.
  607. * There are several mailing lists for ERC. To subscribe, visit
  608. `http://savannah.gnu.org/mail/?group=erc'.
  609. The mailing lists are also available on Gmane.
  610. (`http://gmane.org/'). Gmane provides additional methods for
  611. accessing the mailing lists, adding content to them, and searching
  612. them.
  613. 1. gmane.emacs.erc.announce: Announcements
  614. 2. gmane.emacs.erc.discuss: General discussion
  615. 3. gmane.emacs.erc.cvs: Log messages for changes to the ERC
  616. source code
  617. * You can visit the IRC Freenode channel `#emacs'. Many of the
  618. contributors are frequently around and willing to answer your
  619. questions.
  620. 
  621. File: erc, Node: History, Next: Copying, Prev: Getting Help and Reporting Bugs, Up: Top
  622. 9 History
  623. *********
  624. ERC was originally written by Alexander L. Belikoff <abel@bfr.co.il>
  625. and Sergey Berezin <sergey.berezin@cs.cmu.edu>. They stopped
  626. development around December 1999. Their last released version was ERC
  627. 2.0.
  628. P.S.: If one of the original developers of ERC reads this, we'd like
  629. to receive additional information for this file and hear comments in
  630. general.
  631. * 2001
  632. In June 2001, Mario Lang <mlang@delysid.org> and Alex Schroeder
  633. <alex@gnu.org> took over development and created a ERC Project at
  634. `http://sourceforge.net/projects/erc'.
  635. In reaction to a mail about the new ERC development effort, Sergey
  636. Berezin said, "First of all, I'm glad that my version of ERC is
  637. being used out there. The thing is, I do not have free time and
  638. enough incentive anymore to work on ERC, so I would be happy if
  639. you guys take over the project entirely."
  640. So we happily hacked away on ERC, and soon after (September 2001)
  641. released the next "stable" version, 2.1.
  642. Most of the development of the new ERC happened on #emacs on
  643. irc.openprojects.net. Over time, many people contributed code,
  644. ideas, bugfixes, and a lot of alpha/beta/gamma testing.
  645. See the `CREDITS' file for a list of contributors.
  646. * 2003
  647. ERC 3.0 was released.
  648. * 2004
  649. ERC 4.0 was released.
  650. * 2005
  651. ERC 5.0 was released. Michael Olson <mwolson@gnu.org> became the
  652. release manager and eventually the maintainer.
  653. After some discussion between him and the Emacs developers, it was
  654. decided to include ERC in Emacs.
  655. * 2006
  656. ERC 5.1 was released. It was subsequently included in Emacs 22.
  657. ERC became an official GNU project, and development moved to
  658. `http://sv.gnu.org/projects/erc'. We switched to using GNU Arch as
  659. our revision control system. Our mailing list address changed as
  660. well.
  661. * 2007
  662. We switched to using git for our version control system.
  663. 
  664. File: erc, Node: Copying, Next: GNU Free Documentation License, Prev: History, Up: Top
  665. Version 3, 29 June 2007
  666. Copyright (C) 2007 Free Software Foundation, Inc. `http://fsf.org/'
  667. Everyone is permitted to copy and distribute verbatim copies of this
  668. license document, but changing it is not allowed.
  669. Preamble
  670. ========
  671. The GNU General Public License is a free, copyleft license for software
  672. and other kinds of works.
  673. The licenses for most software and other practical works are designed
  674. to take away your freedom to share and change the works. By contrast,
  675. the GNU General Public License is intended to guarantee your freedom to
  676. share and change all versions of a program--to make sure it remains
  677. free software for all its users. We, the Free Software Foundation, use
  678. the GNU General Public License for most of our software; it applies
  679. also to any other work released this way by its authors. You can apply
  680. it to your programs, too.
  681. When we speak of free software, we are referring to freedom, not
  682. price. Our General Public Licenses are designed to make sure that you
  683. have the freedom to distribute copies of free software (and charge for
  684. them if you wish), that you receive source code or can get it if you
  685. want it, that you can change the software or use pieces of it in new
  686. free programs, and that you know you can do these things.
  687. To protect your rights, we need to prevent others from denying you
  688. these rights or asking you to surrender the rights. Therefore, you
  689. have certain responsibilities if you distribute copies of the software,
  690. or if you modify it: responsibilities to respect the freedom of others.
  691. For example, if you distribute copies of such a program, whether
  692. gratis or for a fee, you must pass on to the recipients the same
  693. freedoms that you received. You must make sure that they, too, receive
  694. or can get the source code. And you must show them these terms so they
  695. know their rights.
  696. Developers that use the GNU GPL protect your rights with two steps:
  697. (1) assert copyright on the software, and (2) offer you this License
  698. giving you legal permission to copy, distribute and/or modify it.
  699. For the developers' and authors' protection, the GPL clearly explains
  700. that there is no warranty for this free software. For both users' and
  701. authors' sake, the GPL requires that modified versions be marked as
  702. changed, so that their problems will not be attributed erroneously to
  703. authors of previous versions.
  704. Some devices are designed to deny users access to install or run
  705. modified versions of the software inside them, although the
  706. manufacturer can do so. This is fundamentally incompatible with the
  707. aim of protecting users' freedom to change the software. The
  708. systematic pattern of such abuse occurs in the area of products for
  709. individuals to use, which is precisely where it is most unacceptable.
  710. Therefore, we have designed this version of the GPL to prohibit the
  711. practice for those products. If such problems arise substantially in
  712. other domains, we stand ready to extend this provision to those domains
  713. in future versions of the GPL, as needed to protect the freedom of
  714. users.
  715. Finally, every program is threatened constantly by software patents.
  716. States should not allow patents to restrict development and use of
  717. software on general-purpose computers, but in those that do, we wish to
  718. avoid the special danger that patents applied to a free program could
  719. make it effectively proprietary. To prevent this, the GPL assures that
  720. patents cannot be used to render the program non-free.
  721. The precise terms and conditions for copying, distribution and
  722. modification follow.
  723. TERMS AND CONDITIONS
  724. ====================
  725. 0. Definitions.
  726. "This License" refers to version 3 of the GNU General Public
  727. License.
  728. "Copyright" also means copyright-like laws that apply to other
  729. kinds of works, such as semiconductor masks.
  730. "The Program" refers to any copyrightable work licensed under this
  731. License. Each licensee is addressed as "you". "Licensees" and
  732. "recipients" may be individuals or organizations.
  733. To "modify" a work means to copy from or adapt all or part of the
  734. work in a fashion requiring copyright permission, other than the
  735. making of an exact copy. The resulting work is called a "modified
  736. version" of the earlier work or a work "based on" the earlier work.
  737. A "covered work" means either the unmodified Program or a work
  738. based on the Program.
  739. To "propagate" a work means to do anything with it that, without
  740. permission, would make you directly or secondarily liable for
  741. infringement under applicable copyright law, except executing it
  742. on a computer or modifying a private copy. Propagation includes
  743. copying, distribution (with or without modification), making
  744. available to the public, and in some countries other activities as
  745. well.
  746. To "convey" a work means any kind of propagation that enables other
  747. parties to make or receive copies. Mere interaction with a user
  748. through a computer network, with no transfer of a copy, is not
  749. conveying.
  750. An interactive user interface displays "Appropriate Legal Notices"
  751. to the extent that it includes a convenient and prominently visible
  752. feature that (1) displays an appropriate copyright notice, and (2)
  753. tells the user that there is no warranty for the work (except to
  754. the extent that warranties are provided), that licensees may
  755. convey the work under this License, and how to view a copy of this
  756. License. If the interface presents a list of user commands or
  757. options, such as a menu, a prominent item in the list meets this
  758. criterion.
  759. 1. Source Code.
  760. The "source code" for a work means the preferred form of the work
  761. for making modifications to it. "Object code" means any
  762. non-source form of a work.
  763. A "Standard Interface" means an interface that either is an
  764. official standard defined by a recognized standards body, or, in
  765. the case of interfaces specified for a particular programming
  766. language, one that is widely used among developers working in that
  767. language.
  768. The "System Libraries" of an executable work include anything,
  769. other than the work as a whole, that (a) is included in the normal
  770. form of packaging a Major Component, but which is not part of that
  771. Major Component, and (b) serves only to enable use of the work
  772. with that Major Component, or to implement a Standard Interface
  773. for which an implementation is available to the public in source
  774. code form. A "Major Component", in this context, means a major
  775. essential component (kernel, window system, and so on) of the
  776. specific operating system (if any) on which the executable work
  777. runs, or a compiler used to produce the work, or an object code
  778. interpreter used to run it.
  779. The "Corresponding Source" for a work in object code form means all
  780. the source code needed to generate, install, and (for an executable
  781. work) run the object code and to modify the work, including
  782. scripts to control those activities. However, it does not include
  783. the work's System Libraries, or general-purpose tools or generally
  784. available free programs which are used unmodified in performing
  785. those activities but which are not part of the work. For example,
  786. Corresponding Source includes interface definition files
  787. associated with source files for the work, and the source code for
  788. shared libraries and dynamically linked subprograms that the work
  789. is specifically designed to require, such as by intimate data
  790. communication or control flow between those subprograms and other
  791. parts of the work.
  792. The Corresponding Source need not include anything that users can
  793. regenerate automatically from other parts of the Corresponding
  794. Source.
  795. The Corresponding Source for a work in source code form is that
  796. same work.
  797. 2. Basic Permissions.
  798. All rights granted under this License are granted for the term of
  799. copyright on the Program, and are irrevocable provided the stated
  800. conditions are met. This License explicitly affirms your unlimited
  801. permission to run the unmodified Program. The output from running
  802. a covered work is covered by this License only if the output,
  803. given its content, constitutes a covered work. This License
  804. acknowledges your rights of fair use or other equivalent, as
  805. provided by copyright law.
  806. You may make, run and propagate covered works that you do not
  807. convey, without conditions so long as your license otherwise
  808. remains in force. You may convey covered works to others for the
  809. sole purpose of having them make modifications exclusively for
  810. you, or provide you with facilities for running those works,
  811. provided that you comply with the terms of this License in
  812. conveying all material for which you do not control copyright.
  813. Those thus making or running the covered works for you must do so
  814. exclusively on your behalf, under your direction and control, on
  815. terms that prohibit them from making any copies of your
  816. copyrighted material outside their relationship with you.
  817. Conveying under any other circumstances is permitted solely under
  818. the conditions stated below. Sublicensing is not allowed; section
  819. 10 makes it unnecessary.
  820. 3. Protecting Users' Legal Rights From Anti-Circumvention Law.
  821. No covered work shall be deemed part of an effective technological
  822. measure under any applicable law fulfilling obligations under
  823. article 11 of the WIPO copyright treaty adopted on 20 December
  824. 1996, or similar laws prohibiting or restricting circumvention of
  825. such measures.
  826. When you convey a covered work, you waive any legal power to forbid
  827. circumvention of technological measures to the extent such
  828. circumvention is effected by exercising rights under this License
  829. with respect to the covered work, and you disclaim any intention
  830. to limit operation or modification of the work as a means of
  831. enforcing, against the work's users, your or third parties' legal
  832. rights to forbid circumvention of technological measures.
  833. 4. Conveying Verbatim Copies.
  834. You may convey verbatim copies of the Program's source code as you
  835. receive it, in any medium, provided that you conspicuously and
  836. appropriately publish on each copy an appropriate copyright notice;
  837. keep intact all notices stating that this License and any
  838. non-permissive terms added in accord with section 7 apply to the
  839. code; keep intact all notices of the absence of any warranty; and
  840. give all recipients a copy of this License along with the Program.
  841. You may charge any price or no price for each copy that you convey,
  842. and you may offer support or warranty protection for a fee.
  843. 5. Conveying Modified Source Versions.
  844. You may convey a work based on the Program, or the modifications to
  845. produce it from the Program, in the form of source code under the
  846. terms of section 4, provided that you also meet all of these
  847. conditions:
  848. a. The work must carry prominent notices stating that you
  849. modified it, and giving a relevant date.
  850. b. The work must carry prominent notices stating that it is
  851. released under this License and any conditions added under
  852. section 7. This requirement modifies the requirement in
  853. section 4 to "keep intact all notices".
  854. c. You must license the entire work, as a whole, under this
  855. License to anyone who comes into possession of a copy. This
  856. License will therefore apply, along with any applicable
  857. section 7 additional terms, to the whole of the work, and all
  858. its parts, regardless of how they are packaged. This License
  859. gives no permission to license the work in any other way, but
  860. it does not invalidate such permission if you have separately
  861. received it.
  862. d. If the work has interactive user interfaces, each must display
  863. Appropriate Legal Notices; however, if the Program has
  864. interactive interfaces that do not display Appropriate Legal
  865. Notices, your work need not make them do so.
  866. A compilation of a covered work with other separate and independent
  867. works, which are not by their nature extensions of the covered
  868. work, and which are not combined with it such as to form a larger
  869. program, in or on a volume of a storage or distribution medium, is
  870. called an "aggregate" if the compilation and its resulting
  871. copyright are not used to limit the access or legal rights of the
  872. compilation's users beyond what the individual works permit.
  873. Inclusion of a covered work in an aggregate does not cause this
  874. License to apply to the other parts of the aggregate.
  875. 6. Conveying Non-Source Forms.
  876. You may convey a covered work in object code form under the terms
  877. of sections 4 and 5, provided that you also convey the
  878. machine-readable Corresponding Source under the terms of this
  879. License, in one of these ways:
  880. a. Convey the object code in, or embodied in, a physical product
  881. (including a physical distribution medium), accompanied by the
  882. Corresponding Source fixed on a durable physical medium
  883. customarily used for software interchange.
  884. b. Convey the object code in, or embodied in, a physical product
  885. (including a physical distribution medium), accompanied by a
  886. written offer, valid for at least three years and valid for
  887. as long as you offer spare parts or customer support for that
  888. product model, to give anyone who possesses the object code
  889. either (1) a copy of the Corresponding Source for all the
  890. software in the product that is covered by this License, on a
  891. durable physical medium customarily used for software
  892. interchange, for a price no more than your reasonable cost of
  893. physically performing this conveying of source, or (2) access
  894. to copy the Corresponding Source from a network server at no
  895. charge.
  896. c. Convey individual copies of the object code with a copy of
  897. the written offer to provide the Corresponding Source. This
  898. alternative is allowed only occasionally and noncommercially,
  899. and only if you received the object code with such an offer,
  900. in accord with subsection 6b.
  901. d. Convey the object code by offering access from a designated
  902. place (gratis or for a charge), and offer equivalent access
  903. to the Corresponding Source in the same way through the same
  904. place at no further charge. You need not require recipients
  905. to copy the Corresponding Source along with the object code.
  906. If the place to copy the object code is a network server, the
  907. Corresponding Source may be on a different server (operated
  908. by you or a third party) that supports equivalent copying
  909. facilities, provided you maintain clear directions next to
  910. the object code saying where to find the Corresponding Source.
  911. Regardless of what server hosts the Corresponding Source, you
  912. remain obligated to ensure that it is available for as long
  913. as needed to satisfy these requirements.
  914. e. Convey the object code using peer-to-peer transmission,
  915. provided you inform other peers where the object code and
  916. Corresponding Source of the work are being offered to the
  917. general public at no charge under subsection 6d.
  918. A separable portion of the object code, whose source code is
  919. excluded from the Corresponding Source as a System Library, need
  920. not be included in conveying the object code work.
  921. A "User Product" is either (1) a "consumer product", which means
  922. any tangible personal property which is normally used for personal,
  923. family, or household purposes, or (2) anything designed or sold for
  924. incorporation into a dwelling. In determining whether a product
  925. is a consumer product, doubtful cases shall be resolved in favor of
  926. coverage. For a particular product received by a particular user,
  927. "normally used" refers to a typical or common use of that class of
  928. product, regardless of the status of the particular user or of the
  929. way in which the particular user actually uses, or expects or is
  930. expected to use, the product. A product is a consumer product
  931. regardless of whether the product has substantial commercial,
  932. industrial or non-consumer uses, unless such uses represent the
  933. only significant mode of use of the product.
  934. "Installation Information" for a User Product means any methods,
  935. procedures, authorization keys, or other information required to
  936. install and execute modified versions of a covered work in that
  937. User Product from a modified version of its Corresponding Source.
  938. The information must suffice to ensure that the continued
  939. functioning of the modified object code is in no case prevented or
  940. interfered with solely because modification has been made.
  941. If you convey an object code work under this section in, or with,
  942. or specifically for use in, a User Product, and the conveying
  943. occurs as part of a transaction in which the right of possession
  944. and use of the User Product is transferred to the recipient in
  945. perpetuity or for a fixed term (regardless of how the transaction
  946. is characterized), the Corresponding Source conveyed under this
  947. section must be accompanied by the Installation Information. But
  948. this requirement does not apply if neither you nor any third party
  949. retains the ability to install modified object code on the User
  950. Product (for example, the work has been installed in ROM).
  951. The requirement to provide Installation Information does not
  952. include a requirement to continue to provide support service,
  953. warranty, or updates for a work that has been modified or
  954. installed by the recipient, or for the User Product in which it
  955. has been modified or installed. Access to a network may be denied
  956. when the modification itself materially and adversely affects the
  957. operation of the network or violates the rules and protocols for
  958. communication across the network.
  959. Corresponding Source conveyed, and Installation Information
  960. provided, in accord with this section must be in a format that is
  961. publicly documented (and with an implementation available to the
  962. public in source code form), and must require no special password
  963. or key for unpacking, reading or copying.
  964. 7. Additional Terms.
  965. "Additional permissions" are terms that supplement the terms of
  966. this License by making exceptions from one or more of its
  967. conditions. Additional permissions that are applicable to the
  968. entire Program shall be treated as though they were included in
  969. this License, to the extent that they are valid under applicable
  970. law. If additional permissions apply only to part of the Program,
  971. that part may be used separately under those permissions, but the
  972. entire Program remains governed by this License without regard to
  973. the additional permissions.
  974. When you convey a copy of a covered work, you may at your option
  975. remove any additional permissions from that copy, or from any part
  976. of it. (Additional permissions may be written to require their own
  977. removal in certain cases when you modify the work.) You may place
  978. additional permissions on material, added by you to a covered work,
  979. for which you have or can give appropriate copyright permission.
  980. Notwithstanding any other provision of this License, for material
  981. you add to a covered work, you may (if authorized by the copyright
  982. holders of that material) supplement the terms of this License
  983. with terms:
  984. a. Disclaiming warranty or limiting liability differently from
  985. the terms of sections 15 and 16 of this License; or
  986. b. Requiring preservation of specified reasonable legal notices
  987. or author attributions in that material or in the Appropriate
  988. Legal Notices displayed by works containing it; or
  989. c. Prohibiting misrepresentation of the origin of that material,
  990. or requiring that modified versions of such material be
  991. marked in reasonable ways as different from the original
  992. version; or
  993. d. Limiting the use for publicity purposes of names of licensors
  994. or authors of the material; or
  995. e. Declining to grant rights under trademark law for use of some
  996. trade names, trademarks, or service marks; or
  997. f. Requiring indemnification of licensors and authors of that
  998. material by anyone who conveys the material (or modified
  999. versions of it) with contractual assumptions of liability to
  1000. the recipient, for any liability that these contractual
  1001. assumptions directly impose on those licensors and authors.
  1002. All other non-permissive additional terms are considered "further
  1003. restrictions" within the meaning of section 10. If the Program as
  1004. you received it, or any part of it, contains a notice stating that
  1005. it is governed by this License along with a term that is a further
  1006. restriction, you may remove that term. If a license document
  1007. contains a further restriction but permits relicensing or
  1008. conveying under this License, you may add to a covered work
  1009. material governed by the terms of that license document, provided
  1010. that the further restriction does not survive such relicensing or
  1011. conveying.
  1012. If you add terms to a covered work in accord with this section, you
  1013. must place, in the relevant source files, a statement of the
  1014. additional terms that apply to those files, or a notice indicating
  1015. where to find the applicable terms.
  1016. Additional terms, permissive or non-permissive, may be stated in
  1017. the form of a separately written license, or stated as exceptions;
  1018. the above requirements apply either way.
  1019. 8. Termination.
  1020. You may not propagate or modify a covered work except as expressly
  1021. provided under this License. Any attempt otherwise to propagate or
  1022. modify it is void, and will automatically terminate your rights
  1023. under this License (including any patent licenses granted under
  1024. the third paragraph of section 11).
  1025. However, if you cease all violation of this License, then your
  1026. license from a particular copyright holder is reinstated (a)
  1027. provisionally, unless and until the copyright holder explicitly
  1028. and finally terminates your license, and (b) permanently, if the
  1029. copyright holder fails to notify you of the violation by some
  1030. reasonable means prior to 60 days after the cessation.
  1031. Moreover, your license from a particular copyright holder is
  1032. reinstated permanently if the copyright holder notifies you of the
  1033. violation by some reasonable means, this is the first time you have
  1034. received notice of violation of this License (for any work) from
  1035. that copyright holder, and you cure the violation prior to 30 days
  1036. after your receipt of the notice.
  1037. Termination of your rights under this section does not terminate
  1038. the licenses of parties who have received copies or rights from
  1039. you under this License. If your rights have been terminated and
  1040. not permanently reinstated, you do not qualify to receive new
  1041. licenses for the same material under section 10.
  1042. 9. Acceptance Not Required for Having Copies.
  1043. You are not required to accept this License in order to receive or
  1044. run a copy of the Program. Ancillary propagation of a covered work
  1045. occurring solely as a consequence of using peer-to-peer
  1046. transmission to receive a copy likewise does not require
  1047. acceptance. However, nothing other than this License grants you
  1048. permission to propagate or modify any covered work. These actions
  1049. infringe copyright if you do not accept this License. Therefore,
  1050. by modifying or propagating a covered work, you indicate your
  1051. acceptance of this License to do so.
  1052. 10. Automatic Licensing of Downstream Recipients.
  1053. Each time you convey a covered work, the recipient automatically
  1054. receives a license from the original licensors, to run, modify and
  1055. propagate that work, subject to this License. You are not
  1056. responsible for enforcing compliance by third parties with this
  1057. License.
  1058. An "entity transaction" is a transaction transferring control of an
  1059. organization, or substantially all assets of one, or subdividing an
  1060. organization, or merging organizations. If propagation of a
  1061. covered work results from an entity transaction, each party to that
  1062. transaction who receives a copy of the work also receives whatever
  1063. licenses to the work the party's predecessor in interest had or
  1064. could give under the previous paragraph, plus a right to
  1065. possession of the Corresponding Source of the work from the
  1066. predecessor in interest, if the predecessor has it or can get it
  1067. with reasonable efforts.
  1068. You may not impose any further restrictions on the exercise of the
  1069. rights granted or affirmed under this License. For example, you
  1070. may not impose a license fee, royalty, or other charge for
  1071. exercise of rights granted under this License, and you may not
  1072. initiate litigation (including a cross-claim or counterclaim in a
  1073. lawsuit) alleging that any patent claim is infringed by making,
  1074. using, selling, offering for sale, or importing the Program or any
  1075. portion of it.
  1076. 11. Patents.
  1077. A "contributor" is a copyright holder who authorizes use under this
  1078. License of the Program or a work on which the Program is based.
  1079. The work thus licensed is called the contributor's "contributor
  1080. version".
  1081. A contributor's "essential patent claims" are all patent claims
  1082. owned or controlled by the contributor, whether already acquired or
  1083. hereafter acquired, that would be infringed by some manner,
  1084. permitted by this License, of making, using, or selling its
  1085. contributor version, but do not include claims that would be
  1086. infringed only as a consequence of further modification of the
  1087. contributor version. For purposes of this definition, "control"
  1088. includes the right to grant patent sublicenses in a manner
  1089. consistent with the requirements of this License.
  1090. Each contributor grants you a non-exclusive, worldwide,
  1091. royalty-free patent license under the contributor's essential
  1092. patent claims, to make, use, sell, offer for sale, import and
  1093. otherwise run, modify and propagate the contents of its
  1094. contributor version.
  1095. In the following three paragraphs, a "patent license" is any
  1096. express agreement or commitment, however denominated, not to
  1097. enforce a patent (such as an express permission to practice a
  1098. patent or covenant not to sue for patent infringement). To
  1099. "grant" such a patent license to a party means to make such an
  1100. agreement or commitment not to enforce a patent against the party.
  1101. If you convey a covered work, knowingly relying on a patent
  1102. license, and the Corresponding Source of the work is not available
  1103. for anyone to copy, free of charge and under the terms of this
  1104. License, through a publicly available network server or other
  1105. readily accessible means, then you must either (1) cause the
  1106. Corresponding Source to be so available, or (2) arrange to deprive
  1107. yourself of the benefit of the patent license for this particular
  1108. work, or (3) arrange, in a manner consistent with the requirements
  1109. of this License, to extend the patent license to downstream
  1110. recipients. "Knowingly relying" means you have actual knowledge
  1111. that, but for the patent license, your conveying the covered work
  1112. in a country, or your recipient's use of the covered work in a
  1113. country, would infringe one or more identifiable patents in that
  1114. country that you have reason to believe are valid.
  1115. If, pursuant to or in connection with a single transaction or
  1116. arrangement, you convey, or propagate by procuring conveyance of, a
  1117. covered work, and grant a patent license to some of the parties
  1118. receiving the covered work authorizing them to use, propagate,
  1119. modify or convey a specific copy of the covered work, then the
  1120. patent license you grant is automatically extended to all
  1121. recipients of the covered work and works based on it.
  1122. A patent license is "discriminatory" if it does not include within
  1123. the scope of its coverage, prohibits the exercise of, or is
  1124. conditioned on the non-exercise of one or more of the rights that
  1125. are specifically granted under this License. You may not convey a
  1126. covered work if you are a party to an arrangement with a third
  1127. party that is in the business of distributing software, under
  1128. which you make payment to the third party based on the extent of
  1129. your activity of conveying the work, and under which the third
  1130. party grants, to any of the parties who would receive the covered
  1131. work from you, a discriminatory patent license (a) in connection
  1132. with copies of the covered work conveyed by you (or copies made
  1133. from those copies), or (b) primarily for and in connection with
  1134. specific products or compilations that contain the covered work,
  1135. unless you entered into that arrangement, or that patent license
  1136. was granted, prior to 28 March 2007.
  1137. Nothing in this License shall be construed as excluding or limiting
  1138. any implied license or other defenses to infringement that may
  1139. otherwise be available to you under applicable patent law.
  1140. 12. No Surrender of Others' Freedom.
  1141. If conditions are imposed on you (whether by court order,
  1142. agreement or otherwise) that contradict the conditions of this
  1143. License, they do not excuse you from the conditions of this
  1144. License. If you cannot convey a covered work so as to satisfy
  1145. simultaneously your obligations under this License and any other
  1146. pertinent obligations, then as a consequence you may not convey it
  1147. at all. For example, if you agree to terms that obligate you to
  1148. collect a royalty for further conveying from those to whom you
  1149. convey the Program, the only way you could satisfy both those
  1150. terms and this License would be to refrain entirely from conveying
  1151. the Program.
  1152. 13. Use with the GNU Affero General Public License.
  1153. Notwithstanding any other provision of this License, you have
  1154. permission to link or combine any covered work with a work licensed
  1155. under version 3 of the GNU Affero General Public License into a
  1156. single combined work, and to convey the resulting work. The terms
  1157. of this License will continue to apply to the part which is the
  1158. covered work, but the special requirements of the GNU Affero
  1159. General Public License, section 13, concerning interaction through
  1160. a network will apply to the combination as such.
  1161. 14. Revised Versions of this License.
  1162. The Free Software Foundation may publish revised and/or new
  1163. versions of the GNU General Public License from time to time.
  1164. Such new versions will be similar in spirit to the present
  1165. version, but may differ in detail to address new problems or
  1166. concerns.
  1167. Each version is given a distinguishing version number. If the
  1168. Program specifies that a certain numbered version of the GNU
  1169. General Public License "or any later version" applies to it, you
  1170. have the option of following the terms and conditions either of
  1171. that numbered version or of any later version published by the
  1172. Free Software Foundation. If the Program does not specify a
  1173. version number of the GNU General Public License, you may choose
  1174. any version ever published by the Free Software Foundation.
  1175. If the Program specifies that a proxy can decide which future
  1176. versions of the GNU General Public License can be used, that
  1177. proxy's public statement of acceptance of a version permanently
  1178. authorizes you to choose that version for the Program.
  1179. Later license versions may give you additional or different
  1180. permissions. However, no additional obligations are imposed on any
  1181. author or copyright holder as a result of your choosing to follow a
  1182. later version.
  1183. 15. Disclaimer of Warranty.
  1184. THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY
  1185. APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE
  1186. COPYRIGHT HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS"
  1187. WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED,
  1188. INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
  1189. MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE
  1190. RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU.
  1191. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL
  1192. NECESSARY SERVICING, REPAIR OR CORRECTION.
  1193. 16. Limitation of Liability.
  1194. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN
  1195. WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES
  1196. AND/OR CONVEYS THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU
  1197. FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR
  1198. CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE
  1199. THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA
  1200. BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD
  1201. PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER
  1202. PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF
  1203. THE POSSIBILITY OF SUCH DAMAGES.
  1204. 17. Interpretation of Sections 15 and 16.
  1205. If the disclaimer of warranty and limitation of liability provided
  1206. above cannot be given local legal effect according to their terms,
  1207. reviewing courts shall apply local law that most closely
  1208. approximates an absolute waiver of all civil liability in
  1209. connection with the Program, unless a warranty or assumption of
  1210. liability accompanies a copy of the Program in return for a fee.
  1211. END OF TERMS AND CONDITIONS
  1212. ===========================
  1213. How to Apply These Terms to Your New Programs
  1214. =============================================
  1215. If you develop a new program, and you want it to be of the greatest
  1216. possible use to the public, the best way to achieve this is to make it
  1217. free software which everyone can redistribute and change under these
  1218. terms.
  1219. To do so, attach the following notices to the program. It is safest
  1220. to attach them to the start of each source file to most effectively
  1221. state the exclusion of warranty; and each file should have at least the
  1222. "copyright" line and a pointer to where the full notice is found.
  1223. ONE LINE TO GIVE THE PROGRAM'S NAME AND A BRIEF IDEA OF WHAT IT DOES.
  1224. Copyright (C) YEAR NAME OF AUTHOR
  1225. This program is free software: you can redistribute it and/or modify
  1226. it under the terms of the GNU General Public License as published by
  1227. the Free Software Foundation, either version 3 of the License, or (at
  1228. your option) any later version.
  1229. This program is distributed in the hope that it will be useful, but
  1230. WITHOUT ANY WARRANTY; without even the implied warranty of
  1231. MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
  1232. General Public License for more details.
  1233. You should have received a copy of the GNU General Public License
  1234. along with this program. If not, see `http://www.gnu.org/licenses/'.
  1235. Also add information on how to contact you by electronic and paper
  1236. mail.
  1237. If the program does terminal interaction, make it output a short
  1238. notice like this when it starts in an interactive mode:
  1239. PROGRAM Copyright (C) YEAR NAME OF AUTHOR
  1240. This program comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
  1241. This is free software, and you are welcome to redistribute it
  1242. under certain conditions; type `show c' for details.
  1243. The hypothetical commands `show w' and `show c' should show the
  1244. appropriate parts of the General Public License. Of course, your
  1245. program's commands might be different; for a GUI interface, you would
  1246. use an "about box".
  1247. You should also get your employer (if you work as a programmer) or
  1248. school, if any, to sign a "copyright disclaimer" for the program, if
  1249. necessary. For more information on this, and how to apply and follow
  1250. the GNU GPL, see `http://www.gnu.org/licenses/'.
  1251. The GNU General Public License does not permit incorporating your
  1252. program into proprietary programs. If your program is a subroutine
  1253. library, you may consider it more useful to permit linking proprietary
  1254. applications with the library. If this is what you want to do, use the
  1255. GNU Lesser General Public License instead of this License. But first,
  1256. please read `http://www.gnu.org/philosophy/why-not-lgpl.html'.
  1257. 
  1258. File: erc, Node: GNU Free Documentation License, Next: Concept Index, Prev: Copying, Up: Top
  1259. Version 1.3, 3 November 2008
  1260. Copyright (C) 2000, 2001, 2002, 2007, 2008, 2009 Free Software Foundation, Inc.
  1261. `http://fsf.org/'
  1262. Everyone is permitted to copy and distribute verbatim copies
  1263. of this license document, but changing it is not allowed.
  1264. 0. PREAMBLE
  1265. The purpose of this License is to make a manual, textbook, or other
  1266. functional and useful document "free" in the sense of freedom: to
  1267. assure everyone the effective freedom to copy and redistribute it,
  1268. with or without modifying it, either commercially or
  1269. noncommercially. Secondarily, this License preserves for the
  1270. author and publisher a way to get credit for their work, while not
  1271. being considered responsible for modifications made by others.
  1272. This License is a kind of "copyleft", which means that derivative
  1273. works of the document must themselves be free in the same sense.
  1274. It complements the GNU General Public License, which is a copyleft
  1275. license designed for free software.
  1276. We have designed this License in order to use it for manuals for
  1277. free software, because free software needs free documentation: a
  1278. free program should come with manuals providing the same freedoms
  1279. that the software does. But this License is not limited to
  1280. software manuals; it can be used for any textual work, regardless
  1281. of subject matter or whether it is published as a printed book.
  1282. We recommend this License principally for works whose purpose is
  1283. instruction or reference.
  1284. 1. APPLICABILITY AND DEFINITIONS
  1285. This License applies to any manual or other work, in any medium,
  1286. that contains a notice placed by the copyright holder saying it
  1287. can be distributed under the terms of this License. Such a notice
  1288. grants a world-wide, royalty-free license, unlimited in duration,
  1289. to use that work under the conditions stated herein. The
  1290. "Document", below, refers to any such manual or work. Any member
  1291. of the public is a licensee, and is addressed as "you". You
  1292. accept the license if you copy, modify or distribute the work in a
  1293. way requiring permission under copyright law.
  1294. A "Modified Version" of the Document means any work containing the
  1295. Document or a portion of it, either copied verbatim, or with
  1296. modifications and/or translated into another language.
  1297. A "Secondary Section" is a named appendix or a front-matter section
  1298. of the Document that deals exclusively with the relationship of the
  1299. publishers or authors of the Document to the Document's overall
  1300. subject (or to related matters) and contains nothing that could
  1301. fall directly within that overall subject. (Thus, if the Document
  1302. is in part a textbook of mathematics, a Secondary Section may not
  1303. explain any mathematics.) The relationship could be a matter of
  1304. historical connection with the subject or with related matters, or
  1305. of legal, commercial, philosophical, ethical or political position
  1306. regarding them.
  1307. The "Invariant Sections" are certain Secondary Sections whose
  1308. titles are designated, as being those of Invariant Sections, in
  1309. the notice that says that the Document is released under this
  1310. License. If a section does not fit the above definition of
  1311. Secondary then it is not allowed to be designated as Invariant.
  1312. The Document may contain zero Invariant Sections. If the Document
  1313. does not identify any Invariant Sections then there are none.
  1314. The "Cover Texts" are certain short passages of text that are
  1315. listed, as Front-Cover Texts or Back-Cover Texts, in the notice
  1316. that says that the Document is released under this License. A
  1317. Front-Cover Text may be at most 5 words, and a Back-Cover Text may
  1318. be at most 25 words.
  1319. A "Transparent" copy of the Document means a machine-readable copy,
  1320. represented in a format whose specification is available to the
  1321. general public, that is suitable for revising the document
  1322. straightforwardly with generic text editors or (for images
  1323. composed of pixels) generic paint programs or (for drawings) some
  1324. widely available drawing editor, and that is suitable for input to
  1325. text formatters or for automatic translation to a variety of
  1326. formats suitable for input to text formatters. A copy made in an
  1327. otherwise Transparent file format whose markup, or absence of
  1328. markup, has been arranged to thwart or discourage subsequent
  1329. modification by readers is not Transparent. An image format is
  1330. not Transparent if used for any substantial amount of text. A
  1331. copy that is not "Transparent" is called "Opaque".
  1332. Examples of suitable formats for Transparent copies include plain
  1333. ASCII without markup, Texinfo input format, LaTeX input format,
  1334. SGML or XML using a publicly available DTD, and
  1335. standard-conforming simple HTML, PostScript or PDF designed for
  1336. human modification. Examples of transparent image formats include
  1337. PNG, XCF and JPG. Opaque formats include proprietary formats that
  1338. can be read and edited only by proprietary word processors, SGML or
  1339. XML for which the DTD and/or processing tools are not generally
  1340. available, and the machine-generated HTML, PostScript or PDF
  1341. produced by some word processors for output purposes only.
  1342. The "Title Page" means, for a printed book, the title page itself,
  1343. plus such following pages as are needed to hold, legibly, the
  1344. material this License requires to appear in the title page. For
  1345. works in formats which do not have any title page as such, "Title
  1346. Page" means the text near the most prominent appearance of the
  1347. work's title, preceding the beginning of the body of the text.
  1348. The "publisher" means any person or entity that distributes copies
  1349. of the Document to the public.
  1350. A section "Entitled XYZ" means a named subunit of the Document
  1351. whose title either is precisely XYZ or contains XYZ in parentheses
  1352. following text that translates XYZ in another language. (Here XYZ
  1353. stands for a specific section name mentioned below, such as
  1354. "Acknowledgements", "Dedications", "Endorsements", or "History".)
  1355. To "Preserve the Title" of such a section when you modify the
  1356. Document means that it remains a section "Entitled XYZ" according
  1357. to this definition.
  1358. The Document may include Warranty Disclaimers next to the notice
  1359. which states that this License applies to the Document. These
  1360. Warranty Disclaimers are considered to be included by reference in
  1361. this License, but only as regards disclaiming warranties: any other
  1362. implication that these Warranty Disclaimers may have is void and
  1363. has no effect on the meaning of this License.
  1364. 2. VERBATIM COPYING
  1365. You may copy and distribute the Document in any medium, either
  1366. commercially or noncommercially, provided that this License, the
  1367. copyright notices, and the license notice saying this License
  1368. applies to the Document are reproduced in all copies, and that you
  1369. add no other conditions whatsoever to those of this License. You
  1370. may not use technical measures to obstruct or control the reading
  1371. or further copying of the copies you make or distribute. However,
  1372. you may accept compensation in exchange for copies. If you
  1373. distribute a large enough number of copies you must also follow
  1374. the conditions in section 3.
  1375. You may also lend copies, under the same conditions stated above,
  1376. and you may publicly display copies.
  1377. 3. COPYING IN QUANTITY
  1378. If you publish printed copies (or copies in media that commonly
  1379. have printed covers) of the Document, numbering more than 100, and
  1380. the Document's license notice requires Cover Texts, you must
  1381. enclose the copies in covers that carry, clearly and legibly, all
  1382. these Cover Texts: Front-Cover Texts on the front cover, and
  1383. Back-Cover Texts on the back cover. Both covers must also clearly
  1384. and legibly identify you as the publisher of these copies. The
  1385. front cover must present the full title with all words of the
  1386. title equally prominent and visible. You may add other material
  1387. on the covers in addition. Copying with changes limited to the
  1388. covers, as long as they preserve the title of the Document and
  1389. satisfy these conditions, can be treated as verbatim copying in
  1390. other respects.
  1391. If the required texts for either cover are too voluminous to fit
  1392. legibly, you should put the first ones listed (as many as fit
  1393. reasonably) on the actual cover, and continue the rest onto
  1394. adjacent pages.
  1395. If you publish or distribute Opaque copies of the Document
  1396. numbering more than 100, you must either include a
  1397. machine-readable Transparent copy along with each Opaque copy, or
  1398. state in or with each Opaque copy a computer-network location from
  1399. which the general network-using public has access to download
  1400. using public-standard network protocols a complete Transparent
  1401. copy of the Document, free of added material. If you use the
  1402. latter option, you must take reasonably prudent steps, when you
  1403. begin distribution of Opaque copies in quantity, to ensure that
  1404. this Transparent copy will remain thus accessible at the stated
  1405. location until at least one year after the last time you
  1406. distribute an Opaque copy (directly or through your agents or
  1407. retailers) of that edition to the public.
  1408. It is requested, but not required, that you contact the authors of
  1409. the Document well before redistributing any large number of
  1410. copies, to give them a chance to provide you with an updated
  1411. version of the Document.
  1412. 4. MODIFICATIONS
  1413. You may copy and distribute a Modified Version of the Document
  1414. under the conditions of sections 2 and 3 above, provided that you
  1415. release the Modified Version under precisely this License, with
  1416. the Modified Version filling the role of the Document, thus
  1417. licensing distribution and modification of the Modified Version to
  1418. whoever possesses a copy of it. In addition, you must do these
  1419. things in the Modified Version:
  1420. A. Use in the Title Page (and on the covers, if any) a title
  1421. distinct from that of the Document, and from those of
  1422. previous versions (which should, if there were any, be listed
  1423. in the History section of the Document). You may use the
  1424. same title as a previous version if the original publisher of
  1425. that version gives permission.
  1426. B. List on the Title Page, as authors, one or more persons or
  1427. entities responsible for authorship of the modifications in
  1428. the Modified Version, together with at least five of the
  1429. principal authors of the Document (all of its principal
  1430. authors, if it has fewer than five), unless they release you
  1431. from this requirement.
  1432. C. State on the Title page the name of the publisher of the
  1433. Modified Version, as the publisher.
  1434. D. Preserve all the copyright notices of the Document.
  1435. E. Add an appropriate copyright notice for your modifications
  1436. adjacent to the other copyright notices.
  1437. F. Include, immediately after the copyright notices, a license
  1438. notice giving the public permission to use the Modified
  1439. Version under the terms of this License, in the form shown in
  1440. the Addendum below.
  1441. G. Preserve in that license notice the full lists of Invariant
  1442. Sections and required Cover Texts given in the Document's
  1443. license notice.
  1444. H. Include an unaltered copy of this License.
  1445. I. Preserve the section Entitled "History", Preserve its Title,
  1446. and add to it an item stating at least the title, year, new
  1447. authors, and publisher of the Modified Version as given on
  1448. the Title Page. If there is no section Entitled "History" in
  1449. the Document, create one stating the title, year, authors,
  1450. and publisher of the Document as given on its Title Page,
  1451. then add an item describing the Modified Version as stated in
  1452. the previous sentence.
  1453. J. Preserve the network location, if any, given in the Document
  1454. for public access to a Transparent copy of the Document, and
  1455. likewise the network locations given in the Document for
  1456. previous versions it was based on. These may be placed in
  1457. the "History" section. You may omit a network location for a
  1458. work that was published at least four years before the
  1459. Document itself, or if the original publisher of the version
  1460. it refers to gives permission.
  1461. K. For any section Entitled "Acknowledgements" or "Dedications",
  1462. Preserve the Title of the section, and preserve in the
  1463. section all the substance and tone of each of the contributor
  1464. acknowledgements and/or dedications given therein.
  1465. L. Preserve all the Invariant Sections of the Document,
  1466. unaltered in their text and in their titles. Section numbers
  1467. or the equivalent are not considered part of the section
  1468. titles.
  1469. M. Delete any section Entitled "Endorsements". Such a section
  1470. may not be included in the Modified Version.
  1471. N. Do not retitle any existing section to be Entitled
  1472. "Endorsements" or to conflict in title with any Invariant
  1473. Section.
  1474. O. Preserve any Warranty Disclaimers.
  1475. If the Modified Version includes new front-matter sections or
  1476. appendices that qualify as Secondary Sections and contain no
  1477. material copied from the Document, you may at your option
  1478. designate some or all of these sections as invariant. To do this,
  1479. add their titles to the list of Invariant Sections in the Modified
  1480. Version's license notice. These titles must be distinct from any
  1481. other section titles.
  1482. You may add a section Entitled "Endorsements", provided it contains
  1483. nothing but endorsements of your Modified Version by various
  1484. parties--for example, statements of peer review or that the text
  1485. has been approved by an organization as the authoritative
  1486. definition of a standard.
  1487. You may add a passage of up to five words as a Front-Cover Text,
  1488. and a passage of up to 25 words as a Back-Cover Text, to the end
  1489. of the list of Cover Texts in the Modified Version. Only one
  1490. passage of Front-Cover Text and one of Back-Cover Text may be
  1491. added by (or through arrangements made by) any one entity. If the
  1492. Document already includes a cover text for the same cover,
  1493. previously added by you or by arrangement made by the same entity
  1494. you are acting on behalf of, you may not add another; but you may
  1495. replace the old one, on explicit permission from the previous
  1496. publisher that added the old one.
  1497. The author(s) and publisher(s) of the Document do not by this
  1498. License give permission to use their names for publicity for or to
  1499. assert or imply endorsement of any Modified Version.
  1500. 5. COMBINING DOCUMENTS
  1501. You may combine the Document with other documents released under
  1502. this License, under the terms defined in section 4 above for
  1503. modified versions, provided that you include in the combination
  1504. all of the Invariant Sections of all of the original documents,
  1505. unmodified, and list them all as Invariant Sections of your
  1506. combined work in its license notice, and that you preserve all
  1507. their Warranty Disclaimers.
  1508. The combined work need only contain one copy of this License, and
  1509. multiple identical Invariant Sections may be replaced with a single
  1510. copy. If there are multiple Invariant Sections with the same name
  1511. but different contents, make the title of each such section unique
  1512. by adding at the end of it, in parentheses, the name of the
  1513. original author or publisher of that section if known, or else a
  1514. unique number. Make the same adjustment to the section titles in
  1515. the list of Invariant Sections in the license notice of the
  1516. combined work.
  1517. In the combination, you must combine any sections Entitled
  1518. "History" in the various original documents, forming one section
  1519. Entitled "History"; likewise combine any sections Entitled
  1520. "Acknowledgements", and any sections Entitled "Dedications". You
  1521. must delete all sections Entitled "Endorsements."
  1522. 6. COLLECTIONS OF DOCUMENTS
  1523. You may make a collection consisting of the Document and other
  1524. documents released under this License, and replace the individual
  1525. copies of this License in the various documents with a single copy
  1526. that is included in the collection, provided that you follow the
  1527. rules of this License for verbatim copying of each of the
  1528. documents in all other respects.
  1529. You may extract a single document from such a collection, and
  1530. distribute it individually under this License, provided you insert
  1531. a copy of this License into the extracted document, and follow
  1532. this License in all other respects regarding verbatim copying of
  1533. that document.
  1534. 7. AGGREGATION WITH INDEPENDENT WORKS
  1535. A compilation of the Document or its derivatives with other
  1536. separate and independent documents or works, in or on a volume of
  1537. a storage or distribution medium, is called an "aggregate" if the
  1538. copyright resulting from the compilation is not used to limit the
  1539. legal rights of the compilation's users beyond what the individual
  1540. works permit. When the Document is included in an aggregate, this
  1541. License does not apply to the other works in the aggregate which
  1542. are not themselves derivative works of the Document.
  1543. If the Cover Text requirement of section 3 is applicable to these
  1544. copies of the Document, then if the Document is less than one half
  1545. of the entire aggregate, the Document's Cover Texts may be placed
  1546. on covers that bracket the Document within the aggregate, or the
  1547. electronic equivalent of covers if the Document is in electronic
  1548. form. Otherwise they must appear on printed covers that bracket
  1549. the whole aggregate.
  1550. 8. TRANSLATION
  1551. Translation is considered a kind of modification, so you may
  1552. distribute translations of the Document under the terms of section
  1553. 4. Replacing Invariant Sections with translations requires special
  1554. permission from their copyright holders, but you may include
  1555. translations of some or all Invariant Sections in addition to the
  1556. original versions of these Invariant Sections. You may include a
  1557. translation of this License, and all the license notices in the
  1558. Document, and any Warranty Disclaimers, provided that you also
  1559. include the original English version of this License and the
  1560. original versions of those notices and disclaimers. In case of a
  1561. disagreement between the translation and the original version of
  1562. this License or a notice or disclaimer, the original version will
  1563. prevail.
  1564. If a section in the Document is Entitled "Acknowledgements",
  1565. "Dedications", or "History", the requirement (section 4) to
  1566. Preserve its Title (section 1) will typically require changing the
  1567. actual title.
  1568. 9. TERMINATION
  1569. You may not copy, modify, sublicense, or distribute the Document
  1570. except as expressly provided under this License. Any attempt
  1571. otherwise to copy, modify, sublicense, or distribute it is void,
  1572. and will automatically terminate your rights under this License.
  1573. However, if you cease all violation of this License, then your
  1574. license from a particular copyright holder is reinstated (a)
  1575. provisionally, unless and until the copyright holder explicitly
  1576. and finally terminates your license, and (b) permanently, if the
  1577. copyright holder fails to notify you of the violation by some
  1578. reasonable means prior to 60 days after the cessation.
  1579. Moreover, your license from a particular copyright holder is
  1580. reinstated permanently if the copyright holder notifies you of the
  1581. violation by some reasonable means, this is the first time you have
  1582. received notice of violation of this License (for any work) from
  1583. that copyright holder, and you cure the violation prior to 30 days
  1584. after your receipt of the notice.
  1585. Termination of your rights under this section does not terminate
  1586. the licenses of parties who have received copies or rights from
  1587. you under this License. If your rights have been terminated and
  1588. not permanently reinstated, receipt of a copy of some or all of
  1589. the same material does not give you any rights to use it.
  1590. 10. FUTURE REVISIONS OF THIS LICENSE
  1591. The Free Software Foundation may publish new, revised versions of
  1592. the GNU Free Documentation License from time to time. Such new
  1593. versions will be similar in spirit to the present version, but may
  1594. differ in detail to address new problems or concerns. See
  1595. `http://www.gnu.org/copyleft/'.
  1596. Each version of the License is given a distinguishing version
  1597. number. If the Document specifies that a particular numbered
  1598. version of this License "or any later version" applies to it, you
  1599. have the option of following the terms and conditions either of
  1600. that specified version or of any later version that has been
  1601. published (not as a draft) by the Free Software Foundation. If
  1602. the Document does not specify a version number of this License,
  1603. you may choose any version ever published (not as a draft) by the
  1604. Free Software Foundation. If the Document specifies that a proxy
  1605. can decide which future versions of this License can be used, that
  1606. proxy's public statement of acceptance of a version permanently
  1607. authorizes you to choose that version for the Document.
  1608. 11. RELICENSING
  1609. "Massive Multiauthor Collaboration Site" (or "MMC Site") means any
  1610. World Wide Web server that publishes copyrightable works and also
  1611. provides prominent facilities for anybody to edit those works. A
  1612. public wiki that anybody can edit is an example of such a server.
  1613. A "Massive Multiauthor Collaboration" (or "MMC") contained in the
  1614. site means any set of copyrightable works thus published on the MMC
  1615. site.
  1616. "CC-BY-SA" means the Creative Commons Attribution-Share Alike 3.0
  1617. license published by Creative Commons Corporation, a not-for-profit
  1618. corporation with a principal place of business in San Francisco,
  1619. California, as well as future copyleft versions of that license
  1620. published by that same organization.
  1621. "Incorporate" means to publish or republish a Document, in whole or
  1622. in part, as part of another Document.
  1623. An MMC is "eligible for relicensing" if it is licensed under this
  1624. License, and if all works that were first published under this
  1625. License somewhere other than this MMC, and subsequently
  1626. incorporated in whole or in part into the MMC, (1) had no cover
  1627. texts or invariant sections, and (2) were thus incorporated prior
  1628. to November 1, 2008.
  1629. The operator of an MMC Site may republish an MMC contained in the
  1630. site under CC-BY-SA on the same site at any time before August 1,
  1631. 2009, provided the MMC is eligible for relicensing.
  1632. ADDENDUM: How to use this License for your documents
  1633. ====================================================
  1634. To use this License in a document you have written, include a copy of
  1635. the License in the document and put the following copyright and license
  1636. notices just after the title page:
  1637. Copyright (C) YEAR YOUR NAME.
  1638. Permission is granted to copy, distribute and/or modify this document
  1639. under the terms of the GNU Free Documentation License, Version 1.3
  1640. or any later version published by the Free Software Foundation;
  1641. with no Invariant Sections, no Front-Cover Texts, and no Back-Cover
  1642. Texts. A copy of the license is included in the section entitled ``GNU
  1643. Free Documentation License''.
  1644. If you have Invariant Sections, Front-Cover Texts and Back-Cover
  1645. Texts, replace the "with...Texts." line with this:
  1646. with the Invariant Sections being LIST THEIR TITLES, with
  1647. the Front-Cover Texts being LIST, and with the Back-Cover Texts
  1648. being LIST.
  1649. If you have Invariant Sections without Cover Texts, or some other
  1650. combination of the three, merge those two alternatives to suit the
  1651. situation.
  1652. If your document contains nontrivial examples of program code, we
  1653. recommend releasing these examples in parallel under your choice of
  1654. free software license, such as the GNU General Public License, to
  1655. permit their use in free software.
  1656. 
  1657. File: erc, Node: Concept Index, Prev: GNU Free Documentation License, Up: Top
  1658. Index
  1659. *****
  1660. [index]
  1661. * Menu:
  1662. * advanced topics: Advanced Usage. (line 6)
  1663. * bugs, reporting: Getting Help and Reporting Bugs.
  1664. (line 6)
  1665. * configuration, sample: Sample Configuration.
  1666. (line 6)
  1667. * connecting: Connecting. (line 6)
  1668. * Debian package for ERC: Releases. (line 12)
  1669. * development: Development. (line 6)
  1670. * erc: Connecting. (line 11)
  1671. * erc-compute-full-name: Connecting. (line 112)
  1672. * erc-compute-nick: Connecting. (line 77)
  1673. * erc-compute-port: Connecting. (line 56)
  1674. * erc-compute-server: Connecting. (line 35)
  1675. * git version control system, using: Development. (line 9)
  1676. * help, getting: Getting Help and Reporting Bugs.
  1677. (line 6)
  1678. * history ring: Special Features. (line 39)
  1679. * history, of ERC: History. (line 6)
  1680. * keystrokes: Keystroke Summary. (line 6)
  1681. * modules: Modules. (line 6)
  1682. * modules, autoaway: Modules. (line 15)
  1683. * modules, autojoin: Modules. (line 18)
  1684. * modules, bbdb: Modules. (line 21)
  1685. * modules, button: Modules. (line 24)
  1686. * modules, capab-identify: Modules. (line 27)
  1687. * modules, completion: Modules. (line 31)
  1688. * modules, fill: Modules. (line 34)
  1689. * modules, hecomplete: Modules. (line 37)
  1690. * modules, identd: Modules. (line 41)
  1691. * modules, irccontrols: Modules. (line 44)
  1692. * modules, log: Modules. (line 47)
  1693. * modules, match: Modules. (line 50)
  1694. * modules, menu: Modules. (line 53)
  1695. * modules, netsplit: Modules. (line 56)
  1696. * modules, noncommands: Modules. (line 59)
  1697. * modules, notify: Modules. (line 62)
  1698. * modules, page: Modules. (line 65)
  1699. * modules, pcomplete: Modules. (line 31)
  1700. * modules, readonly: Modules. (line 68)
  1701. * modules, replace: Modules. (line 71)
  1702. * modules, ring: Modules. (line 74)
  1703. * modules, scrolltobottom: Modules. (line 77)
  1704. * modules, services: Modules. (line 80)
  1705. * modules, smiley: Modules. (line 83)
  1706. * modules, sound: Modules. (line 86)
  1707. * modules, spelling: Modules. (line 89)
  1708. * modules, stamp: Modules. (line 92)
  1709. * modules, track: Modules. (line 95)
  1710. * modules, truncate: Modules. (line 98)
  1711. * modules, unmorse: Modules. (line 101)
  1712. * options: Options. (line 6)
  1713. * query buffers: Special Features. (line 13)
  1714. * releases, Debian package: Releases. (line 12)
  1715. * releases, from source: Releases. (line 15)
  1716. * settings: Getting Started. (line 6)
  1717. * updating ERC with git: Development. (line 66)
  1718. 
  1719. Tag Table:
  1720. Node: Top1100
  1721. Node: Introduction3566
  1722. Node: Obtaining ERC4235
  1723. Node: Releases4894
  1724. Node: Development5469
  1725. Node: Installation8582
  1726. Node: Getting Started10219
  1727. Node: Sample Session11185
  1728. Node: Special Features13588
  1729. Node: Keystroke Summary15881
  1730. Node: Modules18418
  1731. Node: Advanced Usage20482
  1732. Node: Connecting20829
  1733. Node: Sample Configuration24178
  1734. Node: Options27542
  1735. Node: Getting Help and Reporting Bugs27795
  1736. Node: History28924
  1737. Node: Copying30998
  1738. Node: GNU Free Documentation License68493
  1739. Node: Concept Index93575
  1740. 
  1741. End Tag Table