860 lines
35 KiB
Plaintext
860 lines
35 KiB
Plaintext
This is identica-mode.info, produced by makeinfo version 5.2 from
|
||
identica-mode.texi.
|
||
|
||
Copyright (C) 2009 Chris Bryant (<chrisbryant@ucla.edu>). Permission is
|
||
granted to copy, distribute and/or modify this document under the terms
|
||
of the GNU Free Documentation License, Version 1.2 or any later version
|
||
published by the Free Software Foundation; with no Invariant Sections,
|
||
no Front-Cover Texts, and no Back-Cover Texts. A copy of the license is
|
||
included in the section entitled "GNU Free Documentation License".
|
||
INFO-DIR-SECTION Emacs
|
||
START-INFO-DIR-ENTRY
|
||
* Identica mode: (identica-mode). Emacs mode for microblogging services.
|
||
END-INFO-DIR-ENTRY
|
||
|
||
|
||
File: identica-mode.info, Node: Top, Next: About Identica mode and obtaining it, Prev: (dir), Up: (dir)
|
||
|
||
identica-mode
|
||
*************
|
||
|
||
This manual is for identica-mode.el, version 0.9.
|
||
|
||
* Menu:
|
||
|
||
* About Identica mode and obtaining it::
|
||
* Installation and configuration::
|
||
* Using identica-mode.el::
|
||
* Credits and contributing::
|
||
* GNU Free Documentation License::
|
||
|
||
|
||
File: identica-mode.info, Node: About Identica mode and obtaining it, Next: Installation and configuration, Prev: Top, Up: Top
|
||
|
||
1 About Identica mode and obtaining it
|
||
**************************************
|
||
|
||
* Menu:
|
||
|
||
* About identica-mode.el and this manual::
|
||
* Getting a copy::
|
||
|
||
|
||
File: identica-mode.info, Node: About identica-mode.el and this manual, Next: Getting a copy, Prev: About Identica mode and obtaining it, Up: About Identica mode and obtaining it
|
||
|
||
1.1 About identica-mode.el and this manual
|
||
==========================================
|
||
|
||
This manual instructs in the use of identica-mode.el, a major mode for
|
||
GNU Emacs used to perform useful actions with StatusNet
|
||
(http://status.net) microblogging services, like identi.ca
|
||
(http://identi.ca).
|
||
|
||
identica-mode.el was developed by Gabriel Saldana
|
||
(mailto:gsaldana@gmail.com) and other contributors (*note Credits::).
|
||
It is originally based on Twittering mode version 0.6 by Y. Hayamizu and
|
||
Tsuyoshi CHO.
|
||
|
||
|
||
File: identica-mode.info, Node: Getting a copy, Prev: About identica-mode.el and this manual, Up: About Identica mode and obtaining it
|
||
|
||
1.2 Getting a copy
|
||
==================
|
||
|
||
Identica mode can be obtained from the Savannah
|
||
(https://savannah.gnu.org) software forge. The URLs for the Identica
|
||
mode project are:
|
||
|
||
* http://www.nongnu.org/identica-mode
|
||
(http://www.nongnu.org/identica-mode/) - Main website
|
||
* https://savannah.nongnu.org/projects/identica-mode
|
||
(https://savannah.nongnu.org/projects/identica-mode/) - Software
|
||
forge
|
||
|
||
You can obtain identica-mode.el directly from the git repository at
|
||
Savannah by executing a git clone command:
|
||
git clone git://git.savannah.nongnu.org/identica-mode.git
|
||
|
||
This action will fetch the latest identica-mode.el file as well as
|
||
the latest manual, located under the 'doc/' directory.
|
||
|
||
|
||
File: identica-mode.info, Node: Installation and configuration, Next: Using identica-mode.el, Prev: About Identica mode and obtaining it, Up: Top
|
||
|
||
2 Installation and configuration
|
||
********************************
|
||
|
||
* Menu:
|
||
|
||
* Installing identica-mode.el::
|
||
* Configuring GNU Emacs::
|
||
|
||
|
||
File: identica-mode.info, Node: Installing identica-mode.el, Next: Configuring GNU Emacs, Prev: Installation and configuration, Up: Installation and configuration
|
||
|
||
2.1 Installing identica-mode.el
|
||
===============================
|
||
|
||
Installation of indentica-mode.el is fairly straightforward. Like most
|
||
GNU Emacs customizations, it is recommended you place your
|
||
identica-mode.el file under your 'emacs.d' directory. The location of
|
||
this directory will vary between OSs, but it is generally under
|
||
'~/.emacs.d/' for UNIX style systems. Consult your GNU Emacs
|
||
(http://www.gnu.org/software/emacs/) documentation.
|
||
|
||
Alternatively, you can create your own directory for this GNU Emacs
|
||
mode file, and others, if you choose. Read on for information on how to
|
||
configure your '.emacs' file to find indentica-mode.el.
|
||
|
||
|
||
File: identica-mode.info, Node: Configuring GNU Emacs, Prev: Installing identica-mode.el, Up: Installation and configuration
|
||
|
||
2.2 Configuring GNU Emacs
|
||
=========================
|
||
|
||
* Menu:
|
||
|
||
* identica-mode requirements::
|
||
* Configuring .emacs::
|
||
|
||
|
||
File: identica-mode.info, Node: identica-mode requirements, Next: Configuring .emacs, Prev: Configuring GNU Emacs, Up: Configuring GNU Emacs
|
||
|
||
2.2.1 identica-mode requirements
|
||
--------------------------------
|
||
|
||
The following GNU Emacs libraries are required by identica-mode.el. A
|
||
standard GNU Emacs installation should provide these, but if yours does
|
||
not, fetch a copy of the GNU Emacs (http://www.gnu.org/software/emacs/)
|
||
source. The libraries are generally found under the
|
||
'emacs-<version>/lisp/' directory.
|
||
|
||
* cl
|
||
* xml
|
||
* parse-time
|
||
* longlines
|
||
|
||
In addition to the library requirements, the following software is
|
||
currently required:
|
||
|
||
* GNU Emacs 22 or later
|
||
* Curl
|
||
* Wget
|
||
* UNIX-like OS (GNU/Linux, BSD, etcetera)
|
||
|
||
|
||
File: identica-mode.info, Node: Configuring .emacs, Prev: identica-mode requirements, Up: Configuring GNU Emacs
|
||
|
||
2.2.2 Configuring .emacs
|
||
------------------------
|
||
|
||
Some or all or the following settings can be configured from within GNU
|
||
Emacs or written to your '.emacs' file. To configure within GNU Emacs,
|
||
execute 'M-x' and type 'customize-group'. When prompted for the group
|
||
to customize, enter 'identica-mode'. The settings are:
|
||
|
||
* Identica Idle Time
|
||
* Identica Timer Interval
|
||
* Identica Username
|
||
* Identica Password
|
||
* Laconica Server
|
||
* Identica Default Timeline
|
||
* Identica Display Success Messages
|
||
* Identica Update Status Edit Confirm Cancellation
|
||
* Identica Update Status Method
|
||
* Identica Http Get Timeout
|
||
* Identica Status Format
|
||
|
||
For general usage, the defaults for each of these settings (excluding
|
||
Username and Password) should be fine to get started for use with
|
||
identi.ca. If you wish to customize these settings, please see the
|
||
StatusNet wiki (http://status.net/wiki/) for documentation of usage.
|
||
Management of the customizations can also be performed from within your
|
||
'.emacs' file. Below is a sample, explicitly calling the
|
||
identica-mode.el file and with an added global keybinding to allow
|
||
posting from the minibuffer without having the identica buffer active:
|
||
;; Identica Mode
|
||
(load "/home/identicauser/.emacs.d/identica-mode.el")
|
||
(require 'identica-mode)
|
||
(setq identica-username "identicauser")
|
||
(setq identica-password "password")
|
||
(global-set-key "\C-cip" 'identica-update-status-interactive)
|
||
|
||
|
||
|
||
File: identica-mode.info, Node: Using identica-mode.el, Next: Credits and contributing, Prev: Installation and configuration, Up: Top
|
||
|
||
3 Using identica-mode.el
|
||
************************
|
||
|
||
* Menu:
|
||
|
||
* Basic usage::
|
||
* Tips and tricks::
|
||
|
||
|
||
File: identica-mode.info, Node: Basic usage, Next: Tips and tricks, Prev: Using identica-mode.el, Up: Using identica-mode.el
|
||
|
||
3.1 Basic usage
|
||
===============
|
||
|
||
* Menu:
|
||
|
||
* Introduction::
|
||
* Startup::
|
||
* Icons::
|
||
* Replies timeline::
|
||
* Public timeline::
|
||
* Personal timeline::
|
||
* Update status::
|
||
* Send notice::
|
||
* Shorten url::
|
||
|
||
|
||
File: identica-mode.info, Node: Introduction, Next: Startup, Prev: Basic usage, Up: Basic usage
|
||
|
||
3.1.1 Introduction
|
||
------------------
|
||
|
||
Identica mode currently works under GNU Emacs in both terminal and
|
||
graphical mode. Where there are special considerations for one or the
|
||
other mode, they will be clearly highlighted. The purpose of Identica
|
||
mode is to provide an easy method to send and view updates while working
|
||
within a GNU Emacs environment. Thus, the command set detailed below is
|
||
simple. If you are interested in more complex functionality, feel free
|
||
to send suggestions through the Savannah project website. Additionally,
|
||
keep up-to-date with the latest releases. Also, see *note Extending
|
||
identica-mode:: for tips on writing your own functions.
|
||
|
||
|
||
File: identica-mode.info, Node: Startup, Next: Icons, Prev: Introduction, Up: Basic usage
|
||
|
||
3.1.2 Startup
|
||
-------------
|
||
|
||
To get started using Identica mode, execute 'M-x' and type
|
||
'identica-mode'. This will initiate the identica-mode buffer,
|
||
*identica*, and display the default timeline. At any time you wish to
|
||
refresh the timeline, press the 'G' key.
|
||
|
||
|
||
File: identica-mode.info, Node: Icons, Next: Replies timeline, Prev: Startup, Up: Basic usage
|
||
|
||
3.1.3 Icons
|
||
-----------
|
||
|
||
If you are using GNU Emacs with a graphical interface, you can toggle
|
||
the view of user icons by pressing the 'I' key.
|
||
|
||
|
||
File: identica-mode.info, Node: Replies timeline, Next: Public timeline, Prev: Icons, Up: Basic usage
|
||
|
||
3.1.4 Replies timeline
|
||
----------------------
|
||
|
||
To view your Replies timeline execute:
|
||
C-c C-r
|
||
|
||
|
||
File: identica-mode.info, Node: Public timeline, Next: Personal timeline, Prev: Replies timeline, Up: Basic usage
|
||
|
||
3.1.5 Public timeline
|
||
---------------------
|
||
|
||
To view the Public timeline execute:
|
||
C-c C-g
|
||
|
||
|
||
File: identica-mode.info, Node: Personal timeline, Next: Update status, Prev: Public timeline, Up: Basic usage
|
||
|
||
3.1.6 Personal timeline
|
||
-----------------------
|
||
|
||
To view your Personal timeline execute:
|
||
C-c C-f
|
||
|
||
|
||
File: identica-mode.info, Node: Update status, Next: Send notice, Prev: Personal timeline, Up: Basic usage
|
||
|
||
3.1.7 Update status
|
||
-------------------
|
||
|
||
To update your Identica status execute:
|
||
C-c C-s
|
||
|
||
At the 'Status:' prompt, type the content of your status, up to 140
|
||
characters. When done, hit the 'Enter' key. The message 'Success:
|
||
Post' will apper in the minibuffer.
|
||
|
||
|
||
File: identica-mode.info, Node: Send notice, Next: Shorten url, Prev: Update status, Up: Basic usage
|
||
|
||
3.1.8 Send notice
|
||
-----------------
|
||
|
||
To send a notice directly to a user execute:
|
||
C-c C-d
|
||
|
||
At the 'To user:' prompt type the exact user name and press the
|
||
'Enter' key. At the 'Direct message:' prompt, type your message and
|
||
press the 'Enter' key.
|
||
|
||
|
||
File: identica-mode.info, Node: Shorten url, Prev: Send notice, Up: Basic usage
|
||
|
||
3.1.9 Shorten url
|
||
-----------------
|
||
|
||
You can shorten a url while typing your update notice on the minibuffer
|
||
by pressing the '<F4>' key while the cursor is in between or at the end
|
||
of the long url you just typed.
|
||
|
||
|
||
File: identica-mode.info, Node: Tips and tricks, Prev: Basic usage, Up: Using identica-mode.el
|
||
|
||
3.2 Tips and tricks
|
||
===================
|
||
|
||
* Menu:
|
||
|
||
* Run commands after recieving notices::
|
||
* Extending identica-mode::
|
||
|
||
|
||
File: identica-mode.info, Node: Run commands after recieving notices, Prev: Tips and tricks, Up: Tips and tricks
|
||
|
||
3.2.1 Run commands after recieving notices
|
||
------------------------------------------
|
||
|
||
You can now create "hooks" that will run after recieving new notices.
|
||
Just add a hook function to 'identica-new-dents-hook'.
|
||
|
||
To display a notification message on KDE 4 you can add the following
|
||
code on your .emacs file:
|
||
;; KDE 4 Notification of new dents with kdialog
|
||
(add-hook 'identica-new-dents-hook (lambda ()
|
||
(let ((n identica-new-dents-count))
|
||
(start-process "identica-notify" nil "kdialog"
|
||
"--title"
|
||
"Emacs Identica-mode New dents"
|
||
"--passivepopup"
|
||
(format "You have %d new dent%s"
|
||
n (if (> n 1) "s" ""))
|
||
"3"
|
||
))))
|
||
|
||
|
||
File: identica-mode.info, Node: Extending identica-mode, Prev: Tips and tricks, Up: Tips and tricks
|
||
|
||
3.2.2 Extending identica-mode
|
||
-----------------------------
|
||
|
||
Because identica-mode.el is written in Emacs Lisp, there are many
|
||
options to extend the mode to your liking. As this is the first release
|
||
of the Identica mode manual, this section will serve to simply encourage
|
||
you to experiment with the code, and to see *note Contributing:: for
|
||
ways to let us know how you've extended identica-mode.el - maybe we'll
|
||
add your extensions to the code, and this section, in further releases!
|
||
|
||
|
||
File: identica-mode.info, Node: Credits and contributing, Next: GNU Free Documentation License, Prev: Using identica-mode.el, Up: Top
|
||
|
||
4 Credits and contributing
|
||
**************************
|
||
|
||
* Menu:
|
||
|
||
* Credits::
|
||
* Contributing::
|
||
|
||
|
||
File: identica-mode.info, Node: Credits, Next: Contributing, Prev: Credits and contributing, Up: Credits and contributing
|
||
|
||
4.1 Credits
|
||
===========
|
||
|
||
The following individuals have contributed to the Identica mode project.
|
||
See the identica-mode.el file for more information.
|
||
|
||
* Christian Cheng
|
||
* Alberto Garcia
|
||
* Bradley M. Kuhn
|
||
* Jason McBrayer
|
||
* Carlos A. Perilla
|
||
* Alex Schröder
|
||
* Shyam Karanatt
|
||
|
||
|
||
File: identica-mode.info, Node: Contributing, Prev: Credits, Up: Credits and contributing
|
||
|
||
4.2 Contributing
|
||
================
|
||
|
||
If you have any ideas for features, patches or bug fixes, please add
|
||
them to the identica-mode bug tracking list
|
||
(https://savannah.nongnu.org/bugs/?group=identica-mode). If you are
|
||
submitting something specifically for *note Extending identica-mode::,
|
||
be sure to note this in your ticket.
|
||
|
||
|
||
File: identica-mode.info, Node: GNU Free Documentation License, Prev: Credits and contributing, Up: Top
|
||
|
||
GNU Free Documentation License
|
||
******************************
|
||
|
||
Version 1.2, November 2002
|
||
|
||
Copyright (C) 2000,2001,2002 Free Software Foundation, Inc.
|
||
51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
|
||
|
||
Everyone is permitted to copy and distribute verbatim copies
|
||
of this license document, but changing it is not allowed.
|
||
|
||
0. PREAMBLE
|
||
|
||
The purpose of this License is to make a manual, textbook, or other
|
||
functional and useful document "free" in the sense of freedom: to
|
||
assure everyone the effective freedom to copy and redistribute it,
|
||
with or without modifying it, either commercially or
|
||
noncommercially. Secondarily, this License preserves for the
|
||
author and publisher a way to get credit for their work, while not
|
||
being considered responsible for modifications made by others.
|
||
|
||
This License is a kind of "copyleft", which means that derivative
|
||
works of the document must themselves be free in the same sense.
|
||
It complements the GNU General Public License, which is a copyleft
|
||
license designed for free software.
|
||
|
||
We have designed this License in order to use it for manuals for
|
||
free software, because free software needs free documentation: a
|
||
free program should come with manuals providing the same freedoms
|
||
that the software does. But this License is not limited to
|
||
software manuals; it can be used for any textual work, regardless
|
||
of subject matter or whether it is published as a printed book. We
|
||
recommend this License principally for works whose purpose is
|
||
instruction or reference.
|
||
|
||
1. APPLICABILITY AND DEFINITIONS
|
||
|
||
This License applies to any manual or other work, in any medium,
|
||
that contains a notice placed by the copyright holder saying it can
|
||
be distributed under the terms of this License. Such a notice
|
||
grants a world-wide, royalty-free license, unlimited in duration,
|
||
to use that work under the conditions stated herein. The
|
||
"Document", below, refers to any such manual or work. Any member
|
||
of the public is a licensee, and is addressed as "you". You accept
|
||
the license if you copy, modify or distribute the work in a way
|
||
requiring permission under copyright law.
|
||
|
||
A "Modified Version" of the Document means any work containing the
|
||
Document or a portion of it, either copied verbatim, or with
|
||
modifications and/or translated into another language.
|
||
|
||
A "Secondary Section" is a named appendix or a front-matter section
|
||
of the Document that deals exclusively with the relationship of the
|
||
publishers or authors of the Document to the Document's overall
|
||
subject (or to related matters) and contains nothing that could
|
||
fall directly within that overall subject. (Thus, if the Document
|
||
is in part a textbook of mathematics, a Secondary Section may not
|
||
explain any mathematics.) The relationship could be a matter of
|
||
historical connection with the subject or with related matters, or
|
||
of legal, commercial, philosophical, ethical or political position
|
||
regarding them.
|
||
|
||
The "Invariant Sections" are certain Secondary Sections whose
|
||
titles are designated, as being those of Invariant Sections, in the
|
||
notice that says that the Document is released under this License.
|
||
If a section does not fit the above definition of Secondary then it
|
||
is not allowed to be designated as Invariant. The Document may
|
||
contain zero Invariant Sections. If the Document does not identify
|
||
any Invariant Sections then there are none.
|
||
|
||
The "Cover Texts" are certain short passages of text that are
|
||
listed, as Front-Cover Texts or Back-Cover Texts, in the notice
|
||
that says that the Document is released under this License. A
|
||
Front-Cover Text may be at most 5 words, and a Back-Cover Text may
|
||
be at most 25 words.
|
||
|
||
A "Transparent" copy of the Document means a machine-readable copy,
|
||
represented in a format whose specification is available to the
|
||
general public, that is suitable for revising the document
|
||
straightforwardly with generic text editors or (for images composed
|
||
of pixels) generic paint programs or (for drawings) some widely
|
||
available drawing editor, and that is suitable for input to text
|
||
formatters or for automatic translation to a variety of formats
|
||
suitable for input to text formatters. A copy made in an otherwise
|
||
Transparent file format whose markup, or absence of markup, has
|
||
been arranged to thwart or discourage subsequent modification by
|
||
readers is not Transparent. An image format is not Transparent if
|
||
used for any substantial amount of text. A copy that is not
|
||
"Transparent" is called "Opaque".
|
||
|
||
Examples of suitable formats for Transparent copies include plain
|
||
ASCII without markup, Texinfo input format, LaTeX input format,
|
||
SGML or XML using a publicly available DTD, and standard-conforming
|
||
simple HTML, PostScript or PDF designed for human modification.
|
||
Examples of transparent image formats include PNG, XCF and JPG.
|
||
Opaque formats include proprietary formats that can be read and
|
||
edited only by proprietary word processors, SGML or XML for which
|
||
the DTD and/or processing tools are not generally available, and
|
||
the machine-generated HTML, PostScript or PDF produced by some word
|
||
processors for output purposes only.
|
||
|
||
The "Title Page" means, for a printed book, the title page itself,
|
||
plus such following pages as are needed to hold, legibly, the
|
||
material this License requires to appear in the title page. For
|
||
works in formats which do not have any title page as such, "Title
|
||
Page" means the text near the most prominent appearance of the
|
||
work's title, preceding the beginning of the body of the text.
|
||
|
||
A section "Entitled XYZ" means a named subunit of the Document
|
||
whose title either is precisely XYZ or contains XYZ in parentheses
|
||
following text that translates XYZ in another language. (Here XYZ
|
||
stands for a specific section name mentioned below, such as
|
||
"Acknowledgements", "Dedications", "Endorsements", or "History".)
|
||
To "Preserve the Title" of such a section when you modify the
|
||
Document means that it remains a section "Entitled XYZ" according
|
||
to this definition.
|
||
|
||
The Document may include Warranty Disclaimers next to the notice
|
||
which states that this License applies to the Document. These
|
||
Warranty Disclaimers are considered to be included by reference in
|
||
this License, but only as regards disclaiming warranties: any other
|
||
implication that these Warranty Disclaimers may have is void and
|
||
has no effect on the meaning of this License.
|
||
|
||
2. VERBATIM COPYING
|
||
|
||
You may copy and distribute the Document in any medium, either
|
||
commercially or noncommercially, provided that this License, the
|
||
copyright notices, and the license notice saying this License
|
||
applies to the Document are reproduced in all copies, and that you
|
||
add no other conditions whatsoever to those of this License. You
|
||
may not use technical measures to obstruct or control the reading
|
||
or further copying of the copies you make or distribute. However,
|
||
you may accept compensation in exchange for copies. If you
|
||
distribute a large enough number of copies you must also follow the
|
||
conditions in section 3.
|
||
|
||
You may also lend copies, under the same conditions stated above,
|
||
and you may publicly display copies.
|
||
|
||
3. COPYING IN QUANTITY
|
||
|
||
If you publish printed copies (or copies in media that commonly
|
||
have printed covers) of the Document, numbering more than 100, and
|
||
the Document's license notice requires Cover Texts, you must
|
||
enclose the copies in covers that carry, clearly and legibly, all
|
||
these Cover Texts: Front-Cover Texts on the front cover, and
|
||
Back-Cover Texts on the back cover. Both covers must also clearly
|
||
and legibly identify you as the publisher of these copies. The
|
||
front cover must present the full title with all words of the title
|
||
equally prominent and visible. You may add other material on the
|
||
covers in addition. Copying with changes limited to the covers, as
|
||
long as they preserve the title of the Document and satisfy these
|
||
conditions, can be treated as verbatim copying in other respects.
|
||
|
||
If the required texts for either cover are too voluminous to fit
|
||
legibly, you should put the first ones listed (as many as fit
|
||
reasonably) on the actual cover, and continue the rest onto
|
||
adjacent pages.
|
||
|
||
If you publish or distribute Opaque copies of the Document
|
||
numbering more than 100, you must either include a machine-readable
|
||
Transparent copy along with each Opaque copy, or state in or with
|
||
each Opaque copy a computer-network location from which the general
|
||
network-using public has access to download using public-standard
|
||
network protocols a complete Transparent copy of the Document, free
|
||
of added material. If you use the latter option, you must take
|
||
reasonably prudent steps, when you begin distribution of Opaque
|
||
copies in quantity, to ensure that this Transparent copy will
|
||
remain thus accessible at the stated location until at least one
|
||
year after the last time you distribute an Opaque copy (directly or
|
||
through your agents or retailers) of that edition to the public.
|
||
|
||
It is requested, but not required, that you contact the authors of
|
||
the Document well before redistributing any large number of copies,
|
||
to give them a chance to provide you with an updated version of the
|
||
Document.
|
||
|
||
4. MODIFICATIONS
|
||
|
||
You may copy and distribute a Modified Version of the Document
|
||
under the conditions of sections 2 and 3 above, provided that you
|
||
release the Modified Version under precisely this License, with the
|
||
Modified Version filling the role of the Document, thus licensing
|
||
distribution and modification of the Modified Version to whoever
|
||
possesses a copy of it. In addition, you must do these things in
|
||
the Modified Version:
|
||
|
||
A. Use in the Title Page (and on the covers, if any) a title
|
||
distinct from that of the Document, and from those of previous
|
||
versions (which should, if there were any, be listed in the
|
||
History section of the Document). You may use the same title
|
||
as a previous version if the original publisher of that
|
||
version gives permission.
|
||
|
||
B. List on the Title Page, as authors, one or more persons or
|
||
entities responsible for authorship of the modifications in
|
||
the Modified Version, together with at least five of the
|
||
principal authors of the Document (all of its principal
|
||
authors, if it has fewer than five), unless they release you
|
||
from this requirement.
|
||
|
||
C. State on the Title page the name of the publisher of the
|
||
Modified Version, as the publisher.
|
||
|
||
D. Preserve all the copyright notices of the Document.
|
||
|
||
E. Add an appropriate copyright notice for your modifications
|
||
adjacent to the other copyright notices.
|
||
|
||
F. Include, immediately after the copyright notices, a license
|
||
notice giving the public permission to use the Modified
|
||
Version under the terms of this License, in the form shown in
|
||
the Addendum below.
|
||
|
||
G. Preserve in that license notice the full lists of Invariant
|
||
Sections and required Cover Texts given in the Document's
|
||
license notice.
|
||
|
||
H. Include an unaltered copy of this License.
|
||
|
||
I. Preserve the section Entitled "History", Preserve its Title,
|
||
and add to it an item stating at least the title, year, new
|
||
authors, and publisher of the Modified Version as given on the
|
||
Title Page. If there is no section Entitled "History" in the
|
||
Document, create one stating the title, year, authors, and
|
||
publisher of the Document as given on its Title Page, then add
|
||
an item describing the Modified Version as stated in the
|
||
previous sentence.
|
||
|
||
J. Preserve the network location, if any, given in the Document
|
||
for public access to a Transparent copy of the Document, and
|
||
likewise the network locations given in the Document for
|
||
previous versions it was based on. These may be placed in the
|
||
"History" section. You may omit a network location for a work
|
||
that was published at least four years before the Document
|
||
itself, or if the original publisher of the version it refers
|
||
to gives permission.
|
||
|
||
K. For any section Entitled "Acknowledgements" or "Dedications",
|
||
Preserve the Title of the section, and preserve in the section
|
||
all the substance and tone of each of the contributor
|
||
acknowledgements and/or dedications given therein.
|
||
|
||
L. Preserve all the Invariant Sections of the Document, unaltered
|
||
in their text and in their titles. Section numbers or the
|
||
equivalent are not considered part of the section titles.
|
||
|
||
M. Delete any section Entitled "Endorsements". Such a section
|
||
may not be included in the Modified Version.
|
||
|
||
N. Do not retitle any existing section to be Entitled
|
||
"Endorsements" or to conflict in title with any Invariant
|
||
Section.
|
||
|
||
O. Preserve any Warranty Disclaimers.
|
||
|
||
If the Modified Version includes new front-matter sections or
|
||
appendices that qualify as Secondary Sections and contain no
|
||
material copied from the Document, you may at your option designate
|
||
some or all of these sections as invariant. To do this, add their
|
||
titles to the list of Invariant Sections in the Modified Version's
|
||
license notice. These titles must be distinct from any other
|
||
section titles.
|
||
|
||
You may add a section Entitled "Endorsements", provided it contains
|
||
nothing but endorsements of your Modified Version by various
|
||
parties--for example, statements of peer review or that the text
|
||
has been approved by an organization as the authoritative
|
||
definition of a standard.
|
||
|
||
You may add a passage of up to five words as a Front-Cover Text,
|
||
and a passage of up to 25 words as a Back-Cover Text, to the end of
|
||
the list of Cover Texts in the Modified Version. Only one passage
|
||
of Front-Cover Text and one of Back-Cover Text may be added by (or
|
||
through arrangements made by) any one entity. If the Document
|
||
already includes a cover text for the same cover, previously added
|
||
by you or by arrangement made by the same entity you are acting on
|
||
behalf of, you may not add another; but you may replace the old
|
||
one, on explicit permission from the previous publisher that added
|
||
the old one.
|
||
|
||
The author(s) and publisher(s) of the Document do not by this
|
||
License give permission to use their names for publicity for or to
|
||
assert or imply endorsement of any Modified Version.
|
||
|
||
5. COMBINING DOCUMENTS
|
||
|
||
You may combine the Document with other documents released under
|
||
this License, under the terms defined in section 4 above for
|
||
modified versions, provided that you include in the combination all
|
||
of the Invariant Sections of all of the original documents,
|
||
unmodified, and list them all as Invariant Sections of your
|
||
combined work in its license notice, and that you preserve all
|
||
their Warranty Disclaimers.
|
||
|
||
The combined work need only contain one copy of this License, and
|
||
multiple identical Invariant Sections may be replaced with a single
|
||
copy. If there are multiple Invariant Sections with the same name
|
||
but different contents, make the title of each such section unique
|
||
by adding at the end of it, in parentheses, the name of the
|
||
original author or publisher of that section if known, or else a
|
||
unique number. Make the same adjustment to the section titles in
|
||
the list of Invariant Sections in the license notice of the
|
||
combined work.
|
||
|
||
In the combination, you must combine any sections Entitled
|
||
"History" in the various original documents, forming one section
|
||
Entitled "History"; likewise combine any sections Entitled
|
||
"Acknowledgements", and any sections Entitled "Dedications". You
|
||
must delete all sections Entitled "Endorsements."
|
||
|
||
6. COLLECTIONS OF DOCUMENTS
|
||
|
||
You may make a collection consisting of the Document and other
|
||
documents released under this License, and replace the individual
|
||
copies of this License in the various documents with a single copy
|
||
that is included in the collection, provided that you follow the
|
||
rules of this License for verbatim copying of each of the documents
|
||
in all other respects.
|
||
|
||
You may extract a single document from such a collection, and
|
||
distribute it individually under this License, provided you insert
|
||
a copy of this License into the extracted document, and follow this
|
||
License in all other respects regarding verbatim copying of that
|
||
document.
|
||
|
||
7. AGGREGATION WITH INDEPENDENT WORKS
|
||
|
||
A compilation of the Document or its derivatives with other
|
||
separate and independent documents or works, in or on a volume of a
|
||
storage or distribution medium, is called an "aggregate" if the
|
||
copyright resulting from the compilation is not used to limit the
|
||
legal rights of the compilation's users beyond what the individual
|
||
works permit. When the Document is included in an aggregate, this
|
||
License does not apply to the other works in the aggregate which
|
||
are not themselves derivative works of the Document.
|
||
|
||
If the Cover Text requirement of section 3 is applicable to these
|
||
copies of the Document, then if the Document is less than one half
|
||
of the entire aggregate, the Document's Cover Texts may be placed
|
||
on covers that bracket the Document within the aggregate, or the
|
||
electronic equivalent of covers if the Document is in electronic
|
||
form. Otherwise they must appear on printed covers that bracket
|
||
the whole aggregate.
|
||
|
||
8. TRANSLATION
|
||
|
||
Translation is considered a kind of modification, so you may
|
||
distribute translations of the Document under the terms of section
|
||
4. Replacing Invariant Sections with translations requires special
|
||
permission from their copyright holders, but you may include
|
||
translations of some or all Invariant Sections in addition to the
|
||
original versions of these Invariant Sections. You may include a
|
||
translation of this License, and all the license notices in the
|
||
Document, and any Warranty Disclaimers, provided that you also
|
||
include the original English version of this License and the
|
||
original versions of those notices and disclaimers. In case of a
|
||
disagreement between the translation and the original version of
|
||
this License or a notice or disclaimer, the original version will
|
||
prevail.
|
||
|
||
If a section in the Document is Entitled "Acknowledgements",
|
||
"Dedications", or "History", the requirement (section 4) to
|
||
Preserve its Title (section 1) will typically require changing the
|
||
actual title.
|
||
|
||
9. TERMINATION
|
||
|
||
You may not copy, modify, sublicense, or distribute the Document
|
||
except as expressly provided for under this License. Any other
|
||
attempt to copy, modify, sublicense or distribute the Document is
|
||
void, and will automatically terminate your rights under this
|
||
License. However, parties who have received copies, or rights,
|
||
from you under this License will not have their licenses terminated
|
||
so long as such parties remain in full compliance.
|
||
|
||
10. FUTURE REVISIONS OF THIS LICENSE
|
||
|
||
The Free Software Foundation may publish new, revised versions of
|
||
the GNU Free Documentation License from time to time. Such new
|
||
versions will be similar in spirit to the present version, but may
|
||
differ in detail to address new problems or concerns. See
|
||
<http://www.gnu.org/copyleft/>.
|
||
|
||
Each version of the License is given a distinguishing version
|
||
number. If the Document specifies that a particular numbered
|
||
version of this License "or any later version" applies to it, you
|
||
have the option of following the terms and conditions either of
|
||
that specified version or of any later version that has been
|
||
published (not as a draft) by the Free Software Foundation. If the
|
||
Document does not specify a version number of this License, you may
|
||
choose any version ever published (not as a draft) by the Free
|
||
Software Foundation.
|
||
|
||
ADDENDUM: How to use this License for your documents
|
||
====================================================
|
||
|
||
To use this License in a document you have written, include a copy of
|
||
the License in the document and put the following copyright and license
|
||
notices just after the title page:
|
||
|
||
Copyright (C) YEAR YOUR NAME.
|
||
Permission is granted to copy, distribute and/or modify this document
|
||
under the terms of the GNU Free Documentation License, Version 1.2
|
||
or any later version published by the Free Software Foundation;
|
||
with no Invariant Sections, no Front-Cover Texts, and no Back-Cover
|
||
Texts. A copy of the license is included in the section entitled ``GNU
|
||
Free Documentation License''.
|
||
|
||
If you have Invariant Sections, Front-Cover Texts and Back-Cover
|
||
Texts, replace the "with...Texts." line with this:
|
||
|
||
with the Invariant Sections being LIST THEIR TITLES, with
|
||
the Front-Cover Texts being LIST, and with the Back-Cover Texts
|
||
being LIST.
|
||
|
||
If you have Invariant Sections without Cover Texts, or some other
|
||
combination of the three, merge those two alternatives to suit the
|
||
situation.
|
||
|
||
If your document contains nontrivial examples of program code, we
|
||
recommend releasing these examples in parallel under your choice of free
|
||
software license, such as the GNU General Public License, to permit
|
||
their use in free software.
|
||
|
||
|
||
|
||
Tag Table:
|
||
Node: Top652
|
||
Node: About Identica mode and obtaining it1020
|
||
Node: About identica-mode.el and this manual1305
|
||
Node: Getting a copy1996
|
||
Node: Installation and configuration2855
|
||
Node: Installing identica-mode.el3143
|
||
Node: Configuring GNU Emacs3960
|
||
Node: identica-mode requirements4208
|
||
Node: Configuring .emacs4960
|
||
Node: Using identica-mode.el6550
|
||
Node: Basic usage6788
|
||
Node: Introduction7115
|
||
Node: Startup7883
|
||
Node: Icons8244
|
||
Node: Replies timeline8489
|
||
Node: Public timeline8698
|
||
Node: Personal timeline8915
|
||
Node: Update status9136
|
||
Node: Send notice9521
|
||
Node: Shorten url9885
|
||
Node: Tips and tricks10185
|
||
Node: Run commands after recieving notices10406
|
||
Node: Extending identica-mode11273
|
||
Node: Credits and contributing11865
|
||
Node: Credits12100
|
||
Node: Contributing12526
|
||
Node: GNU Free Documentation License12948
|
||
|
||
End Tag Table
|