summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorYoni Rabkin <yoni@rabkins.net>2020-08-11 09:15:54 -0400
committerYoni Rabkin <yoni@rabkins.net>2020-08-11 09:15:54 -0400
commit499326bcad47365a8883a515415bc0ca2571a3ea (patch)
tree63930e350f7188816bd5c02ad5cda5f22069b257
parent41d140c8bd2c14a724f798164e9c206bf865e528 (diff)
fix formatting in dir file
-rw-r--r--dir3
-rw-r--r--doc/Makefile2
-rw-r--r--doc/rt-liberation.texinfo927
-rw-r--r--rt-liberation.info2042
4 files changed, 2 insertions, 2972 deletions
diff --git a/dir b/dir
index f15bdba..184c057 100644
--- a/dir
+++ b/dir
@@ -15,5 +15,4 @@ File: dir, Node: Top This is the top of the INFO tree
* Menu:
Emacs
-* rt-liberation: (rt-liberation).
- Emacs Interface to RT
+* rt-liberation: (rt-liber). Emacs Interface to RT
diff --git a/doc/Makefile b/doc/Makefile
index dd20ede..a9d6a96 100644
--- a/doc/Makefile
+++ b/doc/Makefile
@@ -1,7 +1,7 @@
# Don't delete if make is interrupted
.PRECIOUS: %.info %.html
-all: rt-liberation.info
+all: rt-liber.info
%.info: %.texinfo
makeinfo --no-split $<
diff --git a/doc/rt-liberation.texinfo b/doc/rt-liberation.texinfo
deleted file mode 100644
index 9ffa110..0000000
--- a/doc/rt-liberation.texinfo
+++ /dev/null
@@ -1,927 +0,0 @@
-\input texinfo @c -*-texinfo-*-
-@c %**start of header
-@setfilename rt-liberation.info
-@settitle The rt-liberation Manual
-@c %**end of header
-
-@c History: This manual was started on the 6th of April 2009. Yoni
-@c Rabkin (yrk@gnu.org) is the primary author.
-
-@dircategory Emacs
-@direntry
-* rt-liberation: (rt-liberation). Emacs Interface to RT
-@end direntry
-
-
-@copying
- @copyright{} 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2020 Free Software Foundation, Inc.
-
-@quotation
-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''.
-@end quotation
-@end copying
-
-
-@c For printed material
-@titlepage
-@title The rt-liberation Manual
-@page
-@vskip 0pt plus 1filll
-@insertcopying
-@end titlepage
-@contents
-@c END For printed material
-
-
-@ifnottex
-@node Top, Introduction, (dir), (dir)
-@top The rt-liberation Manual
-
-This is the Manual for the rt-liberation system
-
-@insertcopying
-
-@menu
-* Introduction:: Introduction to rt-liberation.
-* Installation:: Setup rt-liberation to work on the system.
-
-Using rt-liberation
-* Queries:: Retrieve particular tickets from the server.
-* Ticket Browser:: Browse the query results.
-* Ticket Viewer:: Interface to query results.
-
-Extensions
-* Gnus Integration:: Sending email to the RT server via Gnus.
-* Tracking Updates:: Keeping up to date with ticket changes.
-* Batch Operations:: Performing operations on batches of tickets.
-* Local Storage:: Associate arbitrary data with tickets.
-
-Copying and license
-* Copying:: The GNU General Public License gives you
- permission to redistribute rt-liberation
- on certain terms; it also explains that
- there is no warranty.
-
-* The GNU FDL:: The license for this documentation.
-
-Indices
-* Concept Index::
-* Function Index::
-* Variable Index::
-* Keybinding Index::
-
-@detailmenu
- --- The Detailed Node Listing ---
-
-Queries
-
-* Query Compiler:: Compiling Emacs Lisp to TicketSQL.
-* Query Language:: A description of the Sexp-based language.
-
-Ticket Browser
-
-* Ticket Browser Display:: How tickets are displayed in the browser.
-* Ticket Browser Sorting:: How tickets are sorted in the browser.
-* Ticket Browser Filtering:: How to filter tickets out of the browser.
-* Multiple Ticket Browsers:: More than one ticket browser buffer.
-
-@end detailmenu
-@end menu
-
-@end ifnottex
-
-
-@c --------------------------------------------------
-@node Introduction
-@chapter Introduction
-@cindex introduction
-
-rt-liberation is a GNU/Emacs package for working with the Request
-Tracker (henceforth abbreviated as just ``RT'') software from Best
-Practical Solutions. RT has an interactive Web interface, a command
-line interface (the ``RT CLI''), and a REST interface. rt-liberation
-uses the RT REST interface to communicate with the RT server.
-
-rt-liberation allows sending search queries to the RT server, browsing
-the resulting tickets, viewing the tickets' contents and performing
-operations on the tickets.
-
-
-@c --------------------------------------------------
-@node Installation
-@chapter Installation
-@cindex installation
-
-rt-liberation is available via GNU ELPA.
-
-If you install rt-liberation manually instead you'll need to tell
-Emacs where to find it, and tell Emacs to load the package:
-
-@lisp
-(add-to-list 'load-path "/PATH/TO/rt-liberation/")
-@end lisp
-
-@lisp
-(require 'rt-liberation)
-@end lisp
-
-
-rt-liberation needs to be configured in your ~/.emacs, an ~/.rt-liber
-file, or similar.
-
-Tell rt-liberation where to find the RT server's REST interface:
-
-@lisp
-(setq rt-liber-rest-url "rt.example.org")
-@end lisp
-
-rt-liberation can issue a command to ``take'' a ticket (that is,
-assign it to yourself). For this the variable @var{rt-liber-username}
-must be set:
-
-@lisp
-(setq rt-liber-username "someuser")
-@end lisp
-
-rt-liberation can also launch a Web browser to visit a ticket. For
-that to work the base URL needs to be set in
-@var{rt-liber-base-url}. For example:
-
-(setq rt-liber-base-url "https://rt.foo.org/")
-
-
-@c --------------------------------------------------
-@node Queries
-@chapter Queries
-@cindex queries
-
-A typical RT server is meant to manage a large amount of tickets. Much
-more that would be convenient to view all at once. Instead queries are
-used to view only a subset of the tickets on the server.
-
-rt-liberation has its own Sexp-based query language which maps to RT's
-TicketSQL language.
-
-@menu
-* Query Compiler:: Compiling Emacs Lisp to TicketSQL.
-* Query Language:: A description of the Sexp-based language.
-@end menu
-
-
-@c --------------------------------------------------
-@node Query Compiler
-@section Query Compiler
-@cindex query compiler
-
-In order to browse and view tickets a list of needs to be requested
-from the RT server. Typically the tickets answer some kind of
-criteria, for example ``tickets no older than a week owned by me which
-have \``foobar\'' in their subject line''. In RT these criteria are
-formulated with ``TicketSQL'' queries; a structured query language
-specific to RT.
-
-rt-liberation provides a query compiler function to compile Emacs Lisp
-symbolic expressions into TicketSQL. The query compiler supports a
-number of TicketSQL tokens.
-
-
-@c --------------------------------------------------
-@node Query Language
-@section Query Language
-@cindex query language
-
-rt-liberation's Sexp-based query language covers a portion of the
-TicketSQL language. Here are some of the supported TicketSQL tokens:
-Boolean tokens as a means of combining query subsections: ``and'', ``or'',
-``not''. LIKE attribute tokens: ``subject'', ``content''.
-
-For example here is a query with both Boolean and LIKE tokens:
-
-@lisp
-(rt-liber-compile-query
- (and (queue "bugs")
- (content "gnu")))
-
-==> "Queue = 'bugs' AND Content LIKE 'gnu'"
-@end lisp
-
-We can also express negation (note that the compiler produces "!=" and
-"NOT LIKE" for negation depending on the context):
-
-@lisp
-(rt-liber-compile-query
- (and (queue "bugs")
- (not (owner "Nobody"))
- (not (content "sprigz"))
- (status "new")))
-
-==> "Queue = 'licensing' AND Owner != 'Nobody' \
- AND Content NOT LIKE 'sprigz' AND Status = 'new'"
-@end lisp
-
-Attribute tokens which match an attribute to a specific field such as:
-``owner'', ``status'' and ``queue''. Temporal tokens which limit the search
-results to tickets within a certain time interval: ``created'' and
-``lastupdated''. Note that temporal keywords such as ``created'' always
-accept two arguments: BEFORE and AFTER. When either BEFORE or AFTER
-aren't needed, use NIL instead.
-
-One of the advantages of being able to express the TicketSQL queries
-as Emacs Lisp is to be able to express queries using Emacs Lisp
-functions.
-
-Here is a slightly more involved example to illustrate:
-
-@lisp
-(rt-liber-compile-query
- (and (queue "bugs")
- (owner "me@@myaddress.com")
- (status "open")
- (lastupdated nil
- (format-time-string
- "%Y-%m-%d"
- (seconds-to-time
- (- (time-to-seconds (current-time))
- (* 60 60 24 7)))))))
-
-==> "Queue = 'bugs' AND Owner = 'me@@myaddress.com' AND Status = 'open' AND LastUpdated > '2009-03-30'"
-@end lisp
-
-
-Here is an example of how the ticket browser and compiler can be used
-in function calls:
-
-@lisp
-(defun rt-liber-display-ticket (ticket-id)
- "Display ticket with TICKET-ID in the ticket-browser."
- (interactive "MTicket ID: ")
- (rt-liber-browse-query
- (rt-liber-compile-query
- (and (queue "complaints")
- (id ticket-id)))))
-@end lisp
-
-
-@c --------------------------------------------------
-@node Ticket Browser
-@chapter Ticket Browser
-@cindex ticket browser
-
-The ticket browser is a special buffer which provides a convenient
-interface to the results of a server query. The ticket browser can be
-started by invoking: (rt-liber-browse-query QUERY), where QUERY is a
-TicketSQL query. The TicketSQL query can be entered manually as a
-string or as the return value of the query compiler.
-
-@deffn Function rt-liber-browse-query QUERY &optional NEW
-Runs QUERY against the server and launches the browser.
-
-If NEW is non-nil then the query results will be displayed in a new
-buffer, otherwise the query results will override the contents of the
-existing ticket browser buffer. If NEW is a string then that will be
-the name of the new buffer.
-@end deffn
-
-The TicketSQL query can be the return value of the query compiler. For
-example:
-
-@lisp
-(rt-liber-browse-query
- (rt-liber-compile-query
- (and (queue "bugs")
- (content "gnu")))
-@end lisp
-
-
-Since the return value of the query compiler is just a TicketSQL
-string, the following is equivalent:
-
-@lisp
-(rt-liber-browse-query "Queue = 'bugs' AND Content LIKE 'gnu'")
-@end lisp
-
-The ticket browser defines a number of commands:
-
-@table @kbd
-@item q
-@kindex q (ticket browser)
-@findex rt-liber-browser-mode-quit
-Bury the ticket browser buffer.
-
-@item n
-@kindex n (ticket browser)
-@findex rt-liber-next-ticket-in-browser
-Move point to the next ticket.
-
-@item p
-@kindex p (ticket browser)
-@findex rt-liber-previous-ticket-in-browser
-Move point to the previous ticket.
-
-@item RET
-@kindex RET (ticket browser)
-@findex rt-liber-display-ticket-at-point
-Visit the ticket at point in the @xref{Ticket Viewer}.
-
-@item g
-@kindex g (ticket browser)
-@findex revert-buffer
-Refresh the contents of the browser buffer.
-
-@item G
-@kindex G (ticket browser)
-@findex rt-liber-browser-refresh-and-return
-Refresh the contents of the browser buffer. Return point to the
-current ticket after the refresh (if possible).
-
-@item s
-@kindex s (ticket browser)
-@findex rt-liber-browser-mark-as-spam
-Mark the ticket as spam.
-
-@item S
-@kindex S (ticket browser)
-@findex rt-liber-multi-delete-spam
-Delete marked tickets as spam (requires rt-liberation-multi package).
-
-@item a
-@kindex a (ticket browser)
-@findex rt-liber-browser-assign
-Assign the ticket to a user.
-
-@item r
-@kindex r (ticket browser)
-@findex rt-liber-browser-resolve
-Mark the ticket as ``resolved''.
-
-@item o
-@kindex o (ticket browser)
-@findex rt-liber-browser-open
-Mark the ticket as ``open''.
-
-@item t
-@kindex t (ticket browser)
-@findex rt-liber-browser-take-ticket-at-point
-Assign the ticket at point to @var{rt-liber-username}.
-
-@item SPC
-@kindex SPC (ticket browser)
-@findex scroll-up
-Scroll the text of the ticket browser upward.
-
-@item DEL
-@kindex DEL (ticket browser)
-@findex scroll-down
-Scroll the text of the ticket browser downward.
-
-@item m
-@kindex m (ticket browser)
-@findex rt-liber-browser-move
-Move the ticket to a different queue.
-
-@item P
-@kindex P (ticket browser)
-@findex rt-liber-browser-prioritize
-Set the numerical priority level of the ticket at point.
-
-@end table
-
-@menu
-* Ticket Browser Display:: How tickets are displayed in the browser.
-* Ticket Browser Sorting:: How tickets are sorted in the browser.
-* Ticket Browser Filtering:: How to filter tickets out of the browser.
-* Multiple Ticket Browsers:: More than one ticket browser buffer.
-@end menu
-
-
-@c --------------------------------------------------
-@node Ticket Browser Display
-@section Ticket Browser Display
-@cindex ticket browser display function
-
-The ticket browser displays the tickets in the browser by calling
-@dfn{rt-liber-ticketlist-browser-redraw-f} which can be changed and
-customized. Any implementation of
-@dfn{rt-liber-ticketlist-browser-redraw-f} must leave point at the end
-of the ticket text.
-
-The ticket data itself can be displayed using rt-liberation ticket
-format string %-sequences:
-
-@table @asis
-@item %i
-ID number of the ticket in the RT database.
-@item %s
-Subject line.
-@item %c
-Ticket creation time. The format to display the time is specified in
-the variable @var{rt-liber-browser-time-format-string}.
-@item %S
-Ticket status (``open'', ``new'' etc.)
-@item %r
-Whether the ticket is resolved.
-@item %R
-Requestor/s
-@item %C
-Creator of the ticket.
-@item %o
-Owner of the ticket.
-@item %q
-The queue originating the ticket.
-@item %p
-The numerical priority of the ticket
-@end table
-
-Here is an example implementation of
-@dfn{rt-liber-ticketlist-browser-redraw-f} showing the use of the
-%-sequences. Note the use of text properties to add color to ticket
-text. The use of text properties as opposed to font-locking is meant
-to ease customization because otherwise any change in ticket display
-would break the font-locking regular expressions.
-
-@lisp
-(defun rt-liber-ticketlist-browser-redraw-f (ticket)
- "Display TICKET."
- (insert (rt-liber-format "[%c] %i" ticket))
- (add-text-properties (point-at-bol)
- (point-at-eol)
- '(face rt-liber-ticket-face))
- (newline)
- (insert (rt-liber-format " [%S] %s" ticket))
- (newline)
- (insert (rt-liber-format " %o <== %R" ticket)))
-@end lisp
-
-The function @dfn{rt-liber-high-priority-p} can be used to apply a
-different face or text to a ticket if it is high priority. A ticket is
-considered high priority if its value is strictly higher than
-@var{rt-liber-browser-priority-cutoff}
-
-
-@c --------------------------------------------------
-@node Ticket Browser Sorting
-@section Ticket Browser Sorting
-@cindex ticket browser sorting
-
-The tickets in the browser are displayed by default in reverse
-chronological order. Ticket sorting is done by a call to
-@dfn{rt-liber-browser-default-sorting-function}.
-
-Other sorting orders can be used by binding
-@dfn{rt-liber-browser-default-sorting-function} to a different
-function. To ease writing such functions rt-liberation provides two
-predicate functions to perform comparisons between ticket objects:
-
-@defun rt-liber-lex-lessthan-p a b field
-Return true if A is lexicographically less than B in FIELD.
-
-Here is an example of sorting tickets lexicographically by owner name
-using @dfn{rt-liber-lex-lessthan-p} (note that you can feed
-@dfn{rt-liber-lex-lessthan-p} a date/time string and it will sort it
-just fine except that it wouldn't make any sense):
-
-@lisp
-(defun rt-liber-sort-by-owner (ticket-list)
- "Sort TICKET-LIST lexicographically by owner."
- (rt-liber-sort-ticket-list
- ticket-list
- #'(lambda (a b)
- (rt-liber-lex-lessthan-p a b "Owner"))))
-@end lisp
-
-@end defun
-
-@defun rt-liber-time-lessthan-p a b field
-Return t if A is chronologically less than B in FIELD.
-
-Here is an example of sorting tickets lexicographically by owner name
-using @dfn{rt-liber-time-lessthan-p} (note that feeding
-@dfn{rt-liber-time-lessthan-p} anything but a date/time string, in
-this case ``Created'' contains a date, will result in an error being
-signaled).
-
-@lisp
-(defun rt-liber-sort-by-time-created (ticket-list)
- "Sort TICKET-LIST in reverse chronological order."
- (reverse
- (rt-liber-sort-ticket-list
- ticket-list
- #'(lambda (a b)
- (rt-liber-time-lessthan-p a b "Created")))))
-@end lisp
-
-@end defun
-
-
-@c -------------------------------------------------------------------
-@node Ticket Browser Filtering
-@section Ticket Browser Filtering
-@cindex ticket browser filtering filter
-
-The Ticket Browser can also filter out (that is, not display) certain
-tickets based on particular criteria. This probably shouldn't be used
-instead of a properly formed RT query, but when used in conjunction
-with correctly formulated queries it becomes a powerful tool.
-
-During ticket display processing the Ticket Browser will call the
-function pointed to by @var{rt-liber-browser-default-filter-function}
-on each ticket, passing the function the ticket alist as a single
-argument. The function is set by default to
-@dfn{rt-liber-default-filter-f}, which is a function which will
-display all tickets and filter none.
-
-If any tickets are filtered, the Ticket Browser will display the
-filtered ticket count at the bottom ticket listing.
-
-Here is a simple example of how to filter out all of the tickets which
-have a status of ``deleted''.
-
-First we define a custom filter function. Note how it accepts a single
-argument, which is the ticket alist, and returns nil if the ticket is
-to be filtered.
-
-@lisp
-(defun rt-liber-browser-deleted-filter (ticket)
- (not
- (and ticket
- (string= (cdr (assoc "Status" ticket))
- "deleted"))))
-@end lisp
-
-Then we assign that function to be our default filtering function:
-
-@lisp
-(setq rt-liber-browser-default-filter-function
- 'rt-liber-browser-deleted-filter)
-@end lisp
-
-
-@c -------------------------------------------------------------------
-@node Multiple Ticket Browsers
-@section Multiple Ticket Browsers
-@cindex ticket browser multiple buffer
-
-It is sometimes useful to rename the ticket browser buffer to
-something more informative than the default
-@var{rt-liber-browser-buffer-name}, especially if there are multiple
-ticket browsers.
-
-Changing a ticket browser's name can be done normally with
-`rename-buffer', but it is also possible to name the ticket browser
-when it is created. In the following example two ticket browser
-buffers will be created displaying the query results and named
-``*updated by supervisor*'' and ``*new tickets*'' respectively:
-
-@lisp
-(defun rt-liber-daily-rounds ()
- (interactive)
-
- (rt-liber-browse-query
- (rt-liber-compile-query
- (and (queue "complaints")
- (owner "lem.e.tweakit")
- (status "open")
- (lastupdatedby "molly.manager")))
- "*updated by supervisor*")
-
- (rt-liber-browse-query
- (rt-liber-compile-query
- (and (queue "complaints")
- (owner "Nobody")
- (status "new")))
- "*new tickets*"))
-@end lisp
-
-
-@c --------------------------------------------------
-@node Ticket Viewer
-@chapter Ticket Viewer
-@cindex ticket viewer
-
-The ticket viewer is an interface for viewing the contents of a
-ticket. It provides font-locking to make reading the contents easier
-via @var{rt-liber-viewer-font-lock-keywords} and a number of
-key-bindings.
-
-The ticket viewer provides key-bindings to help compose emails to send
-to the RT email interface. The key-bindings for composing email
-described below are generic, what actually happens when you invoke
-them depends on the email-backend system you have installed into
-rt-liberation. @file{rt-liberation-gnus.el} provides integration with
-Gnus, @xref{Gnus Integration}.
-
-Setting @var{rt-liber-jump-to-latest} to `t' will cause the viewer to
-automatically scroll to the latest comment in a ticket when that
-ticket is visited. By default @var{rt-liber-jump-to-latest} is set to
-`nil'.
-
-When in the ticket viewer buffer, invoking
-@dfn{rt-liber-viewer-take-ticket} will ``take'' the ticket.
-
-@table @kbd
-
-@item q
-@kindex q (ticket viewer)
-@findex rt-liber-viewer-mode-quit
-Bury the ticket viewer buffer.
-
-@item n
-@kindex n (ticket viewer)
-@findex rt-liber-next-section-in-viewer
-Move point to the next section in ticket.
-
-@item N
-@kindex N (ticket viewer)
-@findex rt-liber-jump-to-latest-correspondence
-Move point to the newest correspondence section, if any.
-
-@item p
-@kindex p (ticket viewer)
-@findex rt-liber-previous-section-in-viewer
-Move point to the previous section in ticket.
-
-@item V
-@kindex V (ticket viewer)
-@findex rt-liber-viewer-visit-in-browser
-Visit the current ticket in a Web browser.
-
-@item m
-@kindex m (ticket viewer)
-@findex rt-liber-viewer-answer
-Compose an answer to the current ticket.
-
-@item M
-@kindex M (ticket viewer)
-@findex rt-liber-viewer-answer-this
-Compose an answer to the current ticket. The content section around
-point will be inserted into the email body and commented out.
-
-@item t
-@kindex t (ticket viewer)
-@findex rt-liber-viewer-answer-provisionally
-Compose a provisional answer to the current ticket.
-
-@item T
-@kindex t (ticket viewer)
-@findex rt-liber-viewer-answer-provisionally-this
-Compose a provisional answer to the current ticket. The content
-section around point will be inserted into the email body and
-commented out.
-
-@item F
-@kindex F (ticket viewer)
-@findex rt-liber-viewer-answer-verbatim-this
-Compose an answer to the current ticket. The content section around
-point will be inserted into the email body verbatim.
-
-@item c
-@kindex c (ticket viewer)
-@findex rt-liber-viewer-comment
-Compose a comment for the current ticket.
-
-@item C
-@kindex C (ticket viewer)
-@findex rt-liber-viewer-comment-this
-Comment on the ticket using the current context
-
-@item g
-@kindex g (ticket viewer)
-@findex revert-buffer
-Refresh and redisplay the current ticket.
-
-@item SPC
-@kindex SPC (ticket viewer)
-@findex scroll-up
-Scroll text of ticket viewer upward.
-
-@item DEL
-@kindex DEL (ticket viewer)
-@findex scroll-down
-Scroll text of ticket viewer downward.
-
-@item h
-@kindex h (ticket viewer)
-@findex rt-liber-viewer-show-ticket-browser
-Display the associated ticket in the ticket browser.
-
-@end table
-
-
-@c --------------------------------------------------
-@node Gnus Integration
-@chapter Gnus Integration
-@cindex Gnus Integration
-
-The file @file{rt-liberation-gnus.el} implements integration with Gnus
-for composing emails. To enable the feature, `require' it after
-loading rt-liberation:
-
-@lisp
-(require 'rt-liberation-gnus)
-@end lisp
-
-In order for rt-liberation-gnus to be useful a few variables need to
-be specialized. The following is example code which sets these
-variables. Below is a thorough description of those variables.
-
-@lisp
-(setq rt-liber-gnus-comment-address "our-rtserver-comment@@ourserver.org"
- rt-liber-gnus-address "our-rtserver@@ourserver.org"
- rt-liber-gnus-subject-name "ourserver.org")
-@end lisp
-
-@defopt rt-liber-gnus-address
-@var{rt-liber-gnus-address} is the email address which is configured
-in the RT server email interface for sending a response to the
-ticket's requestor.
-@end defopt
-@defopt rt-liber-gnus-comment-address
-@var{rt-liber-gnus-comment-address} is the email address which is
-configured in the RT server email interface for adding a comment under
-the ticket in question.
-@end defopt
-@defopt rt-liber-gnus-subject-name
-@var{rt-liber-gnus-subject-name} is a string, typically included at
-the beginning of the square brackets in the subject. The string is a
-part of the subject line which helps the RT server recognize the
-email.
-@end defopt
-
-Gnus posting styles controlled by @var{gnus-posting-styles} can be
-customized for rt-liberation-gnus by using the variable
-@var{rt-liber-gnus-p}, which is only non-nil when rt-liberation-gnus
-launches a Gnus message buffer.
-
-Here is example code which uses @var{rt-liber-gnus-p} to override the
-signature in the default posting style with one special to
-rt-liberation. Headers can be added and removed in a similar manner.
-
-@lisp
-(setq gnus-posting-styles
- '((".*"
- (name "Lemm E. Hackitt")
- (address "Lemm@@hack.it")
- (signature-file "~/sig.txt")
- ("X-Ethics" "Use GNU"))
- (rt-liber-gnus-p
- (signature-file "~/rt-liber-sig.txt"))))
-@end lisp
-
-
-Once rt-liberation-gnus is loaded and customized the key-bindings in
-the Viewer will be able to call into it, @xref{Ticket Viewer}.
-
-
-@c --------------------------------------------------
-@node Tracking Updates
-@chapter Tracking Updates
-@cindex Tracking Updates
-
-The functions in @file{rt-liberation-update.el} help keep up with
-updates to the ticket database. To enable the feature, `require' it
-after loading rt-liberation:
-
-@lisp
-(require 'rt-liberation-update)
-@end lisp
-
-Then set @var{rt-liber-update-default-queue} to be the name of the
-queue to watch for updates. For example:
-
-@lisp
-(setq rt-liber-update-default-queue "complaints")
-@end lisp
-
-@defun rt-liber-update &optional no-update
-@code{rt-liber-update} is an interactive function which runs a query
-against the RT server asking for the tickets which have been updated
-since the time @code{rt-liber-update} was last run (each time it runs,
-it leaves a time-stamp). If no time-stamp is found, for instance when
-you run @code{rt-liber-update} for the first time, today's date is
-used.
-
-With the NO-UPDATE prefix, @code{rt-liber-update} will not update the
-time-stamp so that the next invocation will produce the same result.
-@end defun
-
-
-@c --------------------------------------------------
-@node Batch Operations
-@chapter Batch Operations
-@cindex Batch Operations
-
-The extension @file{rt-liberation-multi.el} implements performing
-batch operations on groups of tickets. It works in two stages: First
-mark an arbitrary number of tickets within the same buffer then call a
-batch operation function on them. The batch operation functions work
-the same way as function which work on single tickets only that they
-iterate through all of the marked tickets.
-
-To enable batch operations first load @file{rt-liberation-multi.el}:
-
-@lisp
-(require 'rt-liberation-storage)
-@end lisp
-
-@table @kbd
-@item M
-@kindex M (ticket browser)
-@findex rt-liber-mark-ticket-at-point
-Mark the ticket at point for future action. If the ticket at point is
-already marked then unmark it.
-@end table
-
-@defun rt-liber-multi-set-status-open
-Set the status of all the marked tickets to ``open''.
-@end defun
-
-@defun rt-liber-multi-set-status-resolved
-Set the status of all the marked tickets to ``resolved.
-@end defun
-
-@defun rt-liber-multi-assign name
-Assign all of the marked tickets to NAME.
-@end defun
-
-@defun rt-liber-multi-flag-as-spam-and-delete
-Set the status of all the marked tickets to ``is-spam'' and delete.
-@end defun
-
-
-@c --------------------------------------------------
-@node Local Storage
-@chapter Local Storage
-@cindex Local Storage
-
-@file{rt-liberation-storage.el} implements associating arbitrary
-ancillary data with tickets. The data is stored locally and is not
-sent to the RT server.
-
-To enable local storage first load @file{rt-liberation-storage.el}:
-
-@lisp
-(require 'rt-liberation-storage)
-@end lisp
-
-Then enable the display of ancillary data with:
-
-@lisp
-(setq rt-liber-anc-p t)
-@end lisp
-
-The associated data is edited and displayed in the ticket browser with
-the following command key:
-
-@table @kbd
-@item A
-@kindex A (ticket browser)
-@findex rt-liber-browser-ancillary-text
-Associate text with the ticket at point. You will be prompted to enter
-a string of text.
-@end table
-
-Once text is associated with a ticket it will be displayed alongside
-that ticket in the ticket browser. This particular feature lends
-itself to creating private annotations about tickets.
-
-The implementation distributed with rt-liberation allows associating
-text with tickets but is not limited to text. The same implementation
-can be extended to associate any arbitrary data with any ticket.
-
-
-@c --------------------------------------------------
-@c including the relevant licenses
-@include gpl.texi
-@include fdl.texi
-
-
-@c --------------------------------------------------
-@node Concept Index
-@unnumbered Concept Index
-@printindex cp
-
-
-@c --------------------------------------------------
-@node Function Index
-@unnumbered Function Index
-@printindex fn
-
-
-@c --------------------------------------------------
-@node Variable Index
-@unnumbered Variable Index
-@printindex vr
-
-
-@c --------------------------------------------------
-@node Keybinding Index
-@unnumbered Keybinding Index
-@printindex ky
-
-
-@bye
diff --git a/rt-liberation.info b/rt-liberation.info
deleted file mode 100644
index 0f3b847..0000000
--- a/rt-liberation.info
+++ /dev/null
@@ -1,2042 +0,0 @@
-This is rt-liberation.info, produced by makeinfo version 6.1 from
-rt-liberation.texinfo.
-
-(C) 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2020 Free Software
-Foundation, Inc.
-
- 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
-* rt-liberation: (rt-liberation). Emacs Interface to RT
-END-INFO-DIR-ENTRY
-
-
-File: rt-liberation.info, Node: Top, Next: Introduction, Prev: (dir), Up: (dir)
-
-The rt-liberation Manual
-************************
-
-This is the Manual for the rt-liberation system
-
- (C) 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2020 Free Software
-Foundation, Inc.
-
- 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".
-
-* Menu:
-
-* Introduction:: Introduction to rt-liberation.
-* Installation:: Setup rt-liberation to work on the system.
-
-Using rt-liberation
-* Queries:: Retrieve particular tickets from the server.
-* Ticket Browser:: Browse the query results.
-* Ticket Viewer:: Interface to query results.
-
-Extensions
-* Gnus Integration:: Sending email to the RT server via Gnus.
-* Tracking Updates:: Keeping up to date with ticket changes.
-* Batch Operations:: Performing operations on batches of tickets.
-* Local Storage:: Associate arbitrary data with tickets.
-
-Copying and license
-* Copying:: The GNU General Public License gives you
- permission to redistribute rt-liberation
- on certain terms; it also explains that
- there is no warranty.
-
-* The GNU FDL:: The license for this documentation.
-
-Indices
-* Concept Index::
-* Function Index::
-* Variable Index::
-* Keybinding Index::
-
- -- The Detailed Node Listing --
-
-Queries
-
-* Query Compiler:: Compiling Emacs Lisp to TicketSQL.
-* Query Language:: A description of the Sexp-based language.
-
-Ticket Browser
-
-* Ticket Browser Display:: How tickets are displayed in the browser.
-* Ticket Browser Sorting:: How tickets are sorted in the browser.
-* Ticket Browser Filtering:: How to filter tickets out of the browser.
-* Multiple Ticket Browsers:: More than one ticket browser buffer.
-
-
-
-File: rt-liberation.info, Node: Introduction, Next: Installation, Up: Top
-
-1 Introduction
-**************
-
-rt-liberation is a GNU/Emacs package for working with the Request
-Tracker (henceforth abbreviated as just "RT") software from Best
-Practical Solutions. RT has an interactive Web interface, a command
-line interface (the "RT CLI"), and a REST interface. rt-liberation uses
-the RT REST interface to communicate with the RT server.
-
- rt-liberation allows sending search queries to the RT server,
-browsing the resulting tickets, viewing the tickets' contents and
-performing operations on the tickets.
-
-
-File: rt-liberation.info, Node: Installation, Next: Queries, Prev: Introduction, Up: Top
-
-2 Installation
-**************
-
-rt-liberation is available via GNU ELPA.
-
- If you install rt-liberation manually instead you'll need to tell
-Emacs where to find it, and tell Emacs to load the package:
-
- (add-to-list 'load-path "/PATH/TO/rt-liberation/")
-
- (require 'rt-liberation)
-
- rt-liberation needs to be configured in your ~/.emacs, an ~/.rt-liber
-file, or similar.
-
- Tell rt-liberation where to find the RT server's REST interface:
-
- (setq rt-liber-rest-url "rt.example.org")
-
- rt-liberation can issue a command to "take" a ticket (that is, assign
-it to yourself). For this the variable RT-LIBER-USERNAME must be set:
-
- (setq rt-liber-username "someuser")
-
- rt-liberation can also launch a Web browser to visit a ticket. For
-that to work the base URL needs to be set in RT-LIBER-BASE-URL. For
-example:
-
- (setq rt-liber-base-url "https://rt.foo.org/")
-
-
-File: rt-liberation.info, Node: Queries, Next: Ticket Browser, Prev: Installation, Up: Top
-
-3 Queries
-*********
-
-A typical RT server is meant to manage a large amount of tickets. Much
-more that would be convenient to view all at once. Instead queries are
-used to view only a subset of the tickets on the server.
-
- rt-liberation has its own Sexp-based query language which maps to
-RT's TicketSQL language.
-
-* Menu:
-
-* Query Compiler:: Compiling Emacs Lisp to TicketSQL.
-* Query Language:: A description of the Sexp-based language.
-
-
-File: rt-liberation.info, Node: Query Compiler, Next: Query Language, Up: Queries
-
-3.1 Query Compiler
-==================
-
-In order to browse and view tickets a list of needs to be requested from
-the RT server. Typically the tickets answer some kind of criteria, for
-example "tickets no older than a week owned by me which have \"foobar\"
-in their subject line". In RT these criteria are formulated with
-"TicketSQL" queries; a structured query language specific to RT.
-
- rt-liberation provides a query compiler function to compile Emacs
-Lisp symbolic expressions into TicketSQL. The query compiler supports a
-number of TicketSQL tokens.
-
-
-File: rt-liberation.info, Node: Query Language, Prev: Query Compiler, Up: Queries
-
-3.2 Query Language
-==================
-
-rt-liberation's Sexp-based query language covers a portion of the
-TicketSQL language. Here are some of the supported TicketSQL tokens:
-Boolean tokens as a means of combining query subsections: "and", "or",
-"not". LIKE attribute tokens: "subject", "content".
-
- For example here is a query with both Boolean and LIKE tokens:
-
- (rt-liber-compile-query
- (and (queue "bugs")
- (content "gnu")))
-
- ==> "Queue = 'bugs' AND Content LIKE 'gnu'"
-
- We can also express negation (note that the compiler produces "!="
-and "NOT LIKE" for negation depending on the context):
-
- (rt-liber-compile-query
- (and (queue "bugs")
- (not (owner "Nobody"))
- (not (content "sprigz"))
- (status "new")))
-
- ==> "Queue = 'licensing' AND Owner != 'Nobody' \
- AND Content NOT LIKE 'sprigz' AND Status = 'new'"
-
- Attribute tokens which match an attribute to a specific field such
-as: "owner", "status" and "queue". Temporal tokens which limit the
-search results to tickets within a certain time interval: "created" and
-"lastupdated". Note that temporal keywords such as "created" always
-accept two arguments: BEFORE and AFTER. When either BEFORE or AFTER
-aren't needed, use NIL instead.
-
- One of the advantages of being able to express the TicketSQL queries
-as Emacs Lisp is to be able to express queries using Emacs Lisp
-functions.
-
- Here is a slightly more involved example to illustrate:
-
- (rt-liber-compile-query
- (and (queue "bugs")
- (owner "me@myaddress.com")
- (status "open")
- (lastupdated nil
- (format-time-string
- "%Y-%m-%d"
- (seconds-to-time
- (- (time-to-seconds (current-time))
- (* 60 60 24 7)))))))
-
- ==> "Queue = 'bugs' AND Owner = 'me@myaddress.com' AND Status = 'open' AND LastUpdated > '2009-03-30'"
-
- Here is an example of how the ticket browser and compiler can be used
-in function calls:
-
- (defun rt-liber-display-ticket (ticket-id)
- "Display ticket with TICKET-ID in the ticket-browser."
- (interactive "MTicket ID: ")
- (rt-liber-browse-query
- (rt-liber-compile-query
- (and (queue "complaints")
- (id ticket-id)))))
-
-
-File: rt-liberation.info, Node: Ticket Browser, Next: Ticket Viewer, Prev: Queries, Up: Top
-
-4 Ticket Browser
-****************
-
-The ticket browser is a special buffer which provides a convenient
-interface to the results of a server query. The ticket browser can be
-started by invoking: (rt-liber-browse-query QUERY), where QUERY is a
-TicketSQL query. The TicketSQL query can be entered manually as a
-string or as the return value of the query compiler.
-
- -- Function: rt-liber-browse-query QUERY &optional NEW
- Runs QUERY against the server and launches the browser.
-
- If NEW is non-nil then the query results will be displayed in a new
- buffer, otherwise the query results will override the contents of
- the existing ticket browser buffer. If NEW is a string then that
- will be the name of the new buffer.
-
- The TicketSQL query can be the return value of the query compiler.
-For example:
-
- (rt-liber-browse-query
- (rt-liber-compile-query
- (and (queue "bugs")
- (content "gnu")))
-
- Since the return value of the query compiler is just a TicketSQL
-string, the following is equivalent:
-
- (rt-liber-browse-query "Queue = 'bugs' AND Content LIKE 'gnu'")
-
- The ticket browser defines a number of commands:
-
-'q'
- Bury the ticket browser buffer.
-
-'n'
- Move point to the next ticket.
-
-'p'
- Move point to the previous ticket.
-
-'RET'
- Visit the ticket at point in the *Note Ticket Viewer::.
-
-'g'
- Refresh the contents of the browser buffer.
-
-'G'
- Refresh the contents of the browser buffer. Return point to the
- current ticket after the refresh (if possible).
-
-'s'
- Mark the ticket as spam.
-
-'S'
- Delete marked tickets as spam (requires rt-liberation-multi
- package).
-
-'a'
- Assign the ticket to a user.
-
-'r'
- Mark the ticket as "resolved".
-
-'o'
- Mark the ticket as "open".
-
-'t'
- Assign the ticket at point to RT-LIBER-USERNAME.
-
-'SPC'
- Scroll the text of the ticket browser upward.
-
-'DEL'
- Scroll the text of the ticket browser downward.
-
-'m'
- Move the ticket to a different queue.
-
-'P'
- Set the numerical priority level of the ticket at point.
-
-* Menu:
-
-* Ticket Browser Display:: How tickets are displayed in the browser.
-* Ticket Browser Sorting:: How tickets are sorted in the browser.
-* Ticket Browser Filtering:: How to filter tickets out of the browser.
-* Multiple Ticket Browsers:: More than one ticket browser buffer.
-
-
-File: rt-liberation.info, Node: Ticket Browser Display, Next: Ticket Browser Sorting, Up: Ticket Browser
-
-4.1 Ticket Browser Display
-==========================
-
-The ticket browser displays the tickets in the browser by calling
-"rt-liber-ticketlist-browser-redraw-f" which can be changed and
-customized. Any implementation of
-"rt-liber-ticketlist-browser-redraw-f" must leave point at the end of
-the ticket text.
-
- The ticket data itself can be displayed using rt-liberation ticket
-format string %-sequences:
-
-%i
- ID number of the ticket in the RT database.
-%s
- Subject line.
-%c
- Ticket creation time. The format to display the time is specified
- in the variable RT-LIBER-BROWSER-TIME-FORMAT-STRING.
-%S
- Ticket status ("open", "new" etc.)
-%r
- Whether the ticket is resolved.
-%R
- Requestor/s
-%C
- Creator of the ticket.
-%o
- Owner of the ticket.
-%q
- The queue originating the ticket.
-%p
- The numerical priority of the ticket
-
- Here is an example implementation of
-"rt-liber-ticketlist-browser-redraw-f" showing the use of the
-%-sequences. Note the use of text properties to add color to ticket
-text. The use of text properties as opposed to font-locking is meant to
-ease customization because otherwise any change in ticket display would
-break the font-locking regular expressions.
-
- (defun rt-liber-ticketlist-browser-redraw-f (ticket)
- "Display TICKET."
- (insert (rt-liber-format "[%c] %i" ticket))
- (add-text-properties (point-at-bol)
- (point-at-eol)
- '(face rt-liber-ticket-face))
- (newline)
- (insert (rt-liber-format " [%S] %s" ticket))
- (newline)
- (insert (rt-liber-format " %o <== %R" ticket)))
-
- The function "rt-liber-high-priority-p" can be used to apply a
-different face or text to a ticket if it is high priority. A ticket is
-considered high priority if its value is strictly higher than
-RT-LIBER-BROWSER-PRIORITY-CUTOFF
-
-
-File: rt-liberation.info, Node: Ticket Browser Sorting, Next: Ticket Browser Filtering, Prev: Ticket Browser Display, Up: Ticket Browser
-
-4.2 Ticket Browser Sorting
-==========================
-
-The tickets in the browser are displayed by default in reverse
-chronological order. Ticket sorting is done by a call to
-"rt-liber-browser-default-sorting-function".
-
- Other sorting orders can be used by binding
-"rt-liber-browser-default-sorting-function" to a different function. To
-ease writing such functions rt-liberation provides two predicate
-functions to perform comparisons between ticket objects:
-
- -- Function: rt-liber-lex-lessthan-p a b field
- Return true if A is lexicographically less than B in FIELD.
-
- Here is an example of sorting tickets lexicographically by owner
- name using "rt-liber-lex-lessthan-p" (note that you can feed
- "rt-liber-lex-lessthan-p" a date/time string and it will sort it
- just fine except that it wouldn't make any sense):
-
- (defun rt-liber-sort-by-owner (ticket-list)
- "Sort TICKET-LIST lexicographically by owner."
- (rt-liber-sort-ticket-list
- ticket-list
- #'(lambda (a b)
- (rt-liber-lex-lessthan-p a b "Owner"))))
-
- -- Function: rt-liber-time-lessthan-p a b field
- Return t if A is chronologically less than B in FIELD.
-
- Here is an example of sorting tickets lexicographically by owner
- name using "rt-liber-time-lessthan-p" (note that feeding
- "rt-liber-time-lessthan-p" anything but a date/time string, in this
- case "Created" contains a date, will result in an error being
- signaled).
-
- (defun rt-liber-sort-by-time-created (ticket-list)
- "Sort TICKET-LIST in reverse chronological order."
- (reverse
- (rt-liber-sort-ticket-list
- ticket-list
- #'(lambda (a b)
- (rt-liber-time-lessthan-p a b "Created")))))
-
-
-File: rt-liberation.info, Node: Ticket Browser Filtering, Next: Multiple Ticket Browsers, Prev: Ticket Browser Sorting, Up: Ticket Browser
-
-4.3 Ticket Browser Filtering
-============================
-
-The Ticket Browser can also filter out (that is, not display) certain
-tickets based on particular criteria. This probably shouldn't be used
-instead of a properly formed RT query, but when used in conjunction with
-correctly formulated queries it becomes a powerful tool.
-
- During ticket display processing the Ticket Browser will call the
-function pointed to by RT-LIBER-BROWSER-DEFAULT-FILTER-FUNCTION on each
-ticket, passing the function the ticket alist as a single argument. The
-function is set by default to "rt-liber-default-filter-f", which is a
-function which will display all tickets and filter none.
-
- If any tickets are filtered, the Ticket Browser will display the
-filtered ticket count at the bottom ticket listing.
-
- Here is a simple example of how to filter out all of the tickets
-which have a status of "deleted".
-
- First we define a custom filter function. Note how it accepts a
-single argument, which is the ticket alist, and returns nil if the
-ticket is to be filtered.
-
- (defun rt-liber-browser-deleted-filter (ticket)
- (not
- (and ticket
- (string= (cdr (assoc "Status" ticket))
- "deleted"))))
-
- Then we assign that function to be our default filtering function:
-
- (setq rt-liber-browser-default-filter-function
- 'rt-liber-browser-deleted-filter)
-
-
-File: rt-liberation.info, Node: Multiple Ticket Browsers, Prev: Ticket Browser Filtering, Up: Ticket Browser
-
-4.4 Multiple Ticket Browsers
-============================
-
-It is sometimes useful to rename the ticket browser buffer to something
-more informative than the default RT-LIBER-BROWSER-BUFFER-NAME,
-especially if there are multiple ticket browsers.
-
- Changing a ticket browser's name can be done normally with
-'rename-buffer', but it is also possible to name the ticket browser when
-it is created. In the following example two ticket browser buffers will
-be created displaying the query results and named "*updated by
-supervisor*" and "*new tickets*" respectively:
-
- (defun rt-liber-daily-rounds ()
- (interactive)
-
- (rt-liber-browse-query
- (rt-liber-compile-query
- (and (queue "complaints")
- (owner "lem.e.tweakit")
- (status "open")
- (lastupdatedby "molly.manager")))
- "*updated by supervisor*")
-
- (rt-liber-browse-query
- (rt-liber-compile-query
- (and (queue "complaints")
- (owner "Nobody")
- (status "new")))
- "*new tickets*"))
-
-
-File: rt-liberation.info, Node: Ticket Viewer, Next: Gnus Integration, Prev: Ticket Browser, Up: Top
-
-5 Ticket Viewer
-***************
-
-The ticket viewer is an interface for viewing the contents of a ticket.
-It provides font-locking to make reading the contents easier via
-RT-LIBER-VIEWER-FONT-LOCK-KEYWORDS and a number of key-bindings.
-
- The ticket viewer provides key-bindings to help compose emails to
-send to the RT email interface. The key-bindings for composing email
-described below are generic, what actually happens when you invoke them
-depends on the email-backend system you have installed into
-rt-liberation. 'rt-liberation-gnus.el' provides integration with Gnus,
-*Note Gnus Integration::.
-
- Setting RT-LIBER-JUMP-TO-LATEST to 't' will cause the viewer to
-automatically scroll to the latest comment in a ticket when that ticket
-is visited. By default RT-LIBER-JUMP-TO-LATEST is set to 'nil'.
-
- When in the ticket viewer buffer, invoking
-"rt-liber-viewer-take-ticket" will "take" the ticket.
-
-'q'
- Bury the ticket viewer buffer.
-
-'n'
- Move point to the next section in ticket.
-
-'N'
- Move point to the newest correspondence section, if any.
-
-'p'
- Move point to the previous section in ticket.
-
-'V'
- Visit the current ticket in a Web browser.
-
-'m'
- Compose an answer to the current ticket.
-
-'M'
- Compose an answer to the current ticket. The content section
- around point will be inserted into the email body and commented
- out.
-
-'t'
- Compose a provisional answer to the current ticket.
-
-'T'
- Compose a provisional answer to the current ticket. The content
- section around point will be inserted into the email body and
- commented out.
-
-'F'
- Compose an answer to the current ticket. The content section
- around point will be inserted into the email body verbatim.
-
-'c'
- Compose a comment for the current ticket.
-
-'C'
- Comment on the ticket using the current context
-
-'g'
- Refresh and redisplay the current ticket.
-
-'SPC'
- Scroll text of ticket viewer upward.
-
-'DEL'
- Scroll text of ticket viewer downward.
-
-'h'
- Display the associated ticket in the ticket browser.
-
-
-File: rt-liberation.info, Node: Gnus Integration, Next: Tracking Updates, Prev: Ticket Viewer, Up: Top
-
-6 Gnus Integration
-******************
-
-The file 'rt-liberation-gnus.el' implements integration with Gnus for
-composing emails. To enable the feature, 'require' it after loading
-rt-liberation:
-
- (require 'rt-liberation-gnus)
-
- In order for rt-liberation-gnus to be useful a few variables need to
-be specialized. The following is example code which sets these
-variables. Below is a thorough description of those variables.
-
- (setq rt-liber-gnus-comment-address "our-rtserver-comment@ourserver.org"
- rt-liber-gnus-address "our-rtserver@ourserver.org"
- rt-liber-gnus-subject-name "ourserver.org")
-
- -- User Option: rt-liber-gnus-address
- RT-LIBER-GNUS-ADDRESS is the email address which is configured in
- the RT server email interface for sending a response to the
- ticket's requestor.
- -- User Option: rt-liber-gnus-comment-address
- RT-LIBER-GNUS-COMMENT-ADDRESS is the email address which is
- configured in the RT server email interface for adding a comment
- under the ticket in question.
- -- User Option: rt-liber-gnus-subject-name
- RT-LIBER-GNUS-SUBJECT-NAME is a string, typically included at the
- beginning of the square brackets in the subject. The string is a
- part of the subject line which helps the RT server recognize the
- email.
-
- Gnus posting styles controlled by GNUS-POSTING-STYLES can be
-customized for rt-liberation-gnus by using the variable RT-LIBER-GNUS-P,
-which is only non-nil when rt-liberation-gnus launches a Gnus message
-buffer.
-
- Here is example code which uses RT-LIBER-GNUS-P to override the
-signature in the default posting style with one special to
-rt-liberation. Headers can be added and removed in a similar manner.
-
- (setq gnus-posting-styles
- '((".*"
- (name "Lemm E. Hackitt")
- (address "Lemm@hack.it")
- (signature-file "~/sig.txt")
- ("X-Ethics" "Use GNU"))
- (rt-liber-gnus-p
- (signature-file "~/rt-liber-sig.txt"))))
-
- Once rt-liberation-gnus is loaded and customized the key-bindings in
-the Viewer will be able to call into it, *Note Ticket Viewer::.
-
-
-File: rt-liberation.info, Node: Tracking Updates, Next: Batch Operations, Prev: Gnus Integration, Up: Top
-
-7 Tracking Updates
-******************
-
-The functions in 'rt-liberation-update.el' help keep up with updates to
-the ticket database. To enable the feature, 'require' it after loading
-rt-liberation:
-
- (require 'rt-liberation-update)
-
- Then set RT-LIBER-UPDATE-DEFAULT-QUEUE to be the name of the queue to
-watch for updates. For example:
-
- (setq rt-liber-update-default-queue "complaints")
-
- -- Function: rt-liber-update &optional no-update
- 'rt-liber-update' is an interactive function which runs a query
- against the RT server asking for the tickets which have been
- updated since the time 'rt-liber-update' was last run (each time it
- runs, it leaves a time-stamp). If no time-stamp is found, for
- instance when you run 'rt-liber-update' for the first time, today's
- date is used.
-
- With the NO-UPDATE prefix, 'rt-liber-update' will not update the
- time-stamp so that the next invocation will produce the same
- result.
-
-
-File: rt-liberation.info, Node: Batch Operations, Next: Local Storage, Prev: Tracking Updates, Up: Top
-
-8 Batch Operations
-******************
-
-The extension 'rt-liberation-multi.el' implements performing batch
-operations on groups of tickets. It works in two stages: First mark an
-arbitrary number of tickets within the same buffer then call a batch
-operation function on them. The batch operation functions work the same
-way as function which work on single tickets only that they iterate
-through all of the marked tickets.
-
- To enable batch operations first load 'rt-liberation-multi.el':
-
- (require 'rt-liberation-storage)
-
-'M'
- Mark the ticket at point for future action. If the ticket at point
- is already marked then unmark it.
-
- -- Function: rt-liber-multi-set-status-open
- Set the status of all the marked tickets to "open".
-
- -- Function: rt-liber-multi-set-status-resolved
- Set the status of all the marked tickets to "resolved.
-
- -- Function: rt-liber-multi-assign name
- Assign all of the marked tickets to NAME.
-
- -- Function: rt-liber-multi-flag-as-spam-and-delete
- Set the status of all the marked tickets to "is-spam" and delete.
-
-
-File: rt-liberation.info, Node: Local Storage, Next: Copying, Prev: Batch Operations, Up: Top
-
-9 Local Storage
-***************
-
-'rt-liberation-storage.el' implements associating arbitrary ancillary
-data with tickets. The data is stored locally and is not sent to the RT
-server.
-
- To enable local storage first load 'rt-liberation-storage.el':
-
- (require 'rt-liberation-storage)
-
- Then enable the display of ancillary data with:
-
- (setq rt-liber-anc-p t)
-
- The associated data is edited and displayed in the ticket browser
-with the following command key:
-
-'A'
- Associate text with the ticket at point. You will be prompted to
- enter a string of text.
-
- Once text is associated with a ticket it will be displayed alongside
-that ticket in the ticket browser. This particular feature lends itself
-to creating private annotations about tickets.
-
- The implementation distributed with rt-liberation allows associating
-text with tickets but is not limited to text. The same implementation
-can be extended to associate any arbitrary data with any ticket.
-
-
-File: rt-liberation.info, Node: Copying, Next: The GNU FDL, Prev: Local Storage, Up: Top
-
-10 The GNU General Public License.
-**********************************
-
- Version 3, 29 June 2007
-
- Copyright (C) 2007 Free Software Foundation, Inc. <https://fsf.org/>
-
- Everyone is permitted to copy and distribute verbatim copies of this
- license document, but changing it is not allowed.
-
-Preamble
-========
-
-The GNU General Public License is a free, copyleft license for software
-and other kinds of works.
-
- The licenses for most software and other practical works are designed
-to take away your freedom to share and change the works. By contrast,
-the GNU General Public License is intended to guarantee your freedom to
-share and change all versions of a program--to make sure it remains free
-software for all its users. We, the Free Software Foundation, use the
-GNU General Public License for most of our software; it applies also to
-any other work released this way by its authors. You can apply it to
-your programs, too.
-
- When we speak of free software, we are referring to freedom, not
-price. Our General Public Licenses are designed to make sure that you
-have the freedom to distribute copies of free software (and charge for
-them if you wish), that you receive source code or can get it if you
-want it, that you can change the software or use pieces of it in new
-free programs, and that you know you can do these things.
-
- To protect your rights, we need to prevent others from denying you
-these rights or asking you to surrender the rights. Therefore, you have
-certain responsibilities if you distribute copies of the software, or if
-you modify it: responsibilities to respect the freedom of others.
-
- For example, if you distribute copies of such a program, whether
-gratis or for a fee, you must pass on to the recipients the same
-freedoms that you received. You must make sure that they, too, receive
-or can get the source code. And you must show them these terms so they
-know their rights.
-
- Developers that use the GNU GPL protect your rights with two steps:
-(1) assert copyright on the software, and (2) offer you this License
-giving you legal permission to copy, distribute and/or modify it.
-
- For the developers' and authors' protection, the GPL clearly explains
-that there is no warranty for this free software. For both users' and
-authors' sake, the GPL requires that modified versions be marked as
-changed, so that their problems will not be attributed erroneously to
-authors of previous versions.
-
- Some devices are designed to deny users access to install or run
-modified versions of the software inside them, although the manufacturer
-can do so. This is fundamentally incompatible with the aim of
-protecting users' freedom to change the software. The systematic
-pattern of such abuse occurs in the area of products for individuals to
-use, which is precisely where it is most unacceptable. Therefore, we
-have designed this version of the GPL to prohibit the practice for those
-products. If such problems arise substantially in other domains, we
-stand ready to extend this provision to those domains in future versions
-of the GPL, as needed to protect the freedom of users.
-
- Finally, every program is threatened constantly by software patents.
-States should not allow patents to restrict development and use of
-software on general-purpose computers, but in those that do, we wish to
-avoid the special danger that patents applied to a free program could
-make it effectively proprietary. To prevent this, the GPL assures that
-patents cannot be used to render the program non-free.
-
- The precise terms and conditions for copying, distribution and
-modification follow.
-
-TERMS AND CONDITIONS
-====================
-
- 0. Definitions.
-
- "This License" refers to version 3 of the GNU General Public
- License.
-
- "Copyright" also means copyright-like laws that apply to other
- kinds of works, such as semiconductor masks.
-
- "The Program" refers to any copyrightable work licensed under this
- License. Each licensee is addressed as "you". "Licensees" and
- "recipients" may be individuals or organizations.
-
- To "modify" a work means to copy from or adapt all or part of the
- work in a fashion requiring copyright permission, other than the
- making of an exact copy. The resulting work is called a "modified
- version" of the earlier work or a work "based on" the earlier work.
-
- A "covered work" means either the unmodified Program or a work
- based on the Program.
-
- To "propagate" a work means to do anything with it that, without
- permission, would make you directly or secondarily liable for
- infringement under applicable copyright law, except executing it on
- a computer or modifying a private copy. Propagation includes
- copying, distribution (with or without modification), making
- available to the public, and in some countries other activities as
- well.
-
- To "convey" a work means any kind of propagation that enables other
- parties to make or receive copies. Mere interaction with a user
- through a computer network, with no transfer of a copy, is not
- conveying.
-
- An interactive user interface displays "Appropriate Legal Notices"
- to the extent that it includes a convenient and prominently visible
- feature that (1) displays an appropriate copyright notice, and (2)
- tells the user that there is no warranty for the work (except to
- the extent that warranties are provided), that licensees may convey
- the work under this License, and how to view a copy of this
- License. If the interface presents a list of user commands or
- options, such as a menu, a prominent item in the list meets this
- criterion.
-
- 1. Source Code.
-
- The "source code" for a work means the preferred form of the work
- for making modifications to it. "Object code" means any non-source
- form of a work.
-
- A "Standard Interface" means an interface that either is an
- official standard defined by a recognized standards body, or, in
- the case of interfaces specified for a particular programming
- language, one that is widely used among developers working in that
- language.
-
- The "System Libraries" of an executable work include anything,
- other than the work as a whole, that (a) is included in the normal
- form of packaging a Major Component, but which is not part of that
- Major Component, and (b) serves only to enable use of the work with
- that Major Component, or to implement a Standard Interface for
- which an implementation is available to the public in source code
- form. A "Major Component", in this context, means a major
- essential component (kernel, window system, and so on) of the
- specific operating system (if any) on which the executable work
- runs, or a compiler used to produce the work, or an object code
- interpreter used to run it.
-
- The "Corresponding Source" for a work in object code form means all
- the source code needed to generate, install, and (for an executable
- work) run the object code and to modify the work, including scripts
- to control those activities. However, it does not include the
- work's System Libraries, or general-purpose tools or generally
- available free programs which are used unmodified in performing
- those activities but which are not part of the work. For example,
- Corresponding Source includes interface definition files associated
- with source files for the work, and the source code for shared
- libraries and dynamically linked subprograms that the work is
- specifically designed to require, such as by intimate data
- communication or control flow between those subprograms and other
- parts of the work.
-
- The Corresponding Source need not include anything that users can
- regenerate automatically from other parts of the Corresponding
- Source.
-
- The Corresponding Source for a work in source code form is that
- same work.
-
- 2. Basic Permissions.
-
- All rights granted under this License are granted for the term of
- copyright on the Program, and are irrevocable provided the stated
- conditions are met. This License explicitly affirms your unlimited
- permission to run the unmodified Program. The output from running
- a covered work is covered by this License only if the output, given
- its content, constitutes a covered work. This License acknowledges
- your rights of fair use or other equivalent, as provided by
- copyright law.
-
- You may make, run and propagate covered works that you do not
- convey, without conditions so long as your license otherwise
- remains in force. You may convey covered works to others for the
- sole purpose of having them make modifications exclusively for you,
- or provide you with facilities for running those works, provided
- that you comply with the terms of this License in conveying all
- material for which you do not control copyright. Those thus making
- or running the covered works for you must do so exclusively on your
- behalf, under your direction and control, on terms that prohibit
- them from making any copies of your copyrighted material outside
- their relationship with you.
-
- Conveying under any other circumstances is permitted solely under
- the conditions stated below. Sublicensing is not allowed; section
- 10 makes it unnecessary.
-
- 3. Protecting Users' Legal Rights From Anti-Circumvention Law.
-
- No covered work shall be deemed part of an effective technological
- measure under any applicable law fulfilling obligations under
- article 11 of the WIPO copyright treaty adopted on 20 December
- 1996, or similar laws prohibiting or restricting circumvention of
- such measures.
-
- When you convey a covered work, you waive any legal power to forbid
- circumvention of technological measures to the extent such
- circumvention is effected by exercising rights under this License
- with respect to the covered work, and you disclaim any intention to
- limit operation or modification of the work as a means of
- enforcing, against the work's users, your or third parties' legal
- rights to forbid circumvention of technological measures.
-
- 4. Conveying Verbatim Copies.
-
- You may convey verbatim copies of the Program's source code as you
- receive it, in any medium, provided that you conspicuously and
- appropriately publish on each copy an appropriate copyright notice;
- keep intact all notices stating that this License and any
- non-permissive terms added in accord with section 7 apply to the
- code; keep intact all notices of the absence of any warranty; and
- give all recipients a copy of this License along with the Program.
-
- You may charge any price or no price for each copy that you convey,
- and you may offer support or warranty protection for a fee.
-
- 5. Conveying Modified Source Versions.
-
- You may convey a work based on the Program, or the modifications to
- produce it from the Program, in the form of source code under the
- terms of section 4, provided that you also meet all of these
- conditions:
-
- a. The work must carry prominent notices stating that you
- modified it, and giving a relevant date.
-
- b. The work must carry prominent notices stating that it is
- released under this License and any conditions added under
- section 7. This requirement modifies the requirement in
- section 4 to "keep intact all notices".
-
- c. You must license the entire work, as a whole, under this
- License to anyone who comes into possession of a copy. This
- License will therefore apply, along with any applicable
- section 7 additional terms, to the whole of the work, and all
- its parts, regardless of how they are packaged. This License
- gives no permission to license the work in any other way, but
- it does not invalidate such permission if you have separately
- received it.
-
- d. If the work has interactive user interfaces, each must display
- Appropriate Legal Notices; however, if the Program has
- interactive interfaces that do not display Appropriate Legal
- Notices, your work need not make them do so.
-
- A compilation of a covered work with other separate and independent
- works, which are not by their nature extensions of the covered
- work, and which are not combined with it such as to form a larger
- program, in or on a volume of a storage or distribution medium, is
- called an "aggregate" if the compilation and its resulting
- copyright are not used to limit the access or legal rights of the
- compilation's users beyond what the individual works permit.
- Inclusion of a covered work in an aggregate does not cause this
- License to apply to the other parts of the aggregate.
-
- 6. Conveying Non-Source Forms.
-
- You may convey a covered work in object code form under the terms
- of sections 4 and 5, provided that you also convey the
- machine-readable Corresponding Source under the terms of this
- License, in one of these ways:
-
- a. Convey the object code in, or embodied in, a physical product
- (including a physical distribution medium), accompanied by the
- Corresponding Source fixed on a durable physical medium
- customarily used for software interchange.
-
- b. Convey the object code in, or embodied in, a physical product
- (including a physical distribution medium), accompanied by a
- written offer, valid for at least three years and valid for as
- long as you offer spare parts or customer support for that
- product model, to give anyone who possesses the object code
- either (1) a copy of the Corresponding Source for all the
- software in the product that is covered by this License, on a
- durable physical medium customarily used for software
- interchange, for a price no more than your reasonable cost of
- physically performing this conveying of source, or (2) access
- to copy the Corresponding Source from a network server at no
- charge.
-
- c. Convey individual copies of the object code with a copy of the
- written offer to provide the Corresponding Source. This
- alternative is allowed only occasionally and noncommercially,
- and only if you received the object code with such an offer,
- in accord with subsection 6b.
-
- d. Convey the object code by offering access from a designated
- place (gratis or for a charge), and offer equivalent access to
- the Corresponding Source in the same way through the same
- place at no further charge. You need not require recipients
- to copy the Corresponding Source along with the object code.
- If the place to copy the object code is a network server, the
- Corresponding Source may be on a different server (operated by
- you or a third party) that supports equivalent copying
- facilities, provided you maintain clear directions next to the
- object code saying where to find the Corresponding Source.
- Regardless of what server hosts the Corresponding Source, you
- remain obligated to ensure that it is available for as long as
- needed to satisfy these requirements.
-
- e. Convey the object code using peer-to-peer transmission,
- provided you inform other peers where the object code and
- Corresponding Source of the work are being offered to the
- general public at no charge under subsection 6d.
-
- A separable portion of the object code, whose source code is
- excluded from the Corresponding Source as a System Library, need
- not be included in conveying the object code work.
-
- A "User Product" is either (1) a "consumer product", which means
- any tangible personal property which is normally used for personal,
- family, or household purposes, or (2) anything designed or sold for
- incorporation into a dwelling. In determining whether a product is
- a consumer product, doubtful cases shall be resolved in favor of
- coverage. For a particular product received by a particular user,
- "normally used" refers to a typical or common use of that class of
- product, regardless of the status of the particular user or of the
- way in which the particular user actually uses, or expects or is
- expected to use, the product. A product is a consumer product
- regardless of whether the product has substantial commercial,
- industrial or non-consumer uses, unless such uses represent the
- only significant mode of use of the product.
-
- "Installation Information" for a User Product means any methods,
- procedures, authorization keys, or other information required to
- install and execute modified versions of a covered work in that
- User Product from a modified version of its Corresponding Source.
- The information must suffice to ensure that the continued
- functioning of the modified object code is in no case prevented or
- interfered with solely because modification has been made.
-
- If you convey an object code work under this section in, or with,
- or specifically for use in, a User Product, and the conveying
- occurs as part of a transaction in which the right of possession
- and use of the User Product is transferred to the recipient in
- perpetuity or for a fixed term (regardless of how the transaction
- is characterized), the Corresponding Source conveyed under this
- section must be accompanied by the Installation Information. But
- this requirement does not apply if neither you nor any third party
- retains the ability to install modified object code on the User
- Product (for example, the work has been installed in ROM).
-
- The requirement to provide Installation Information does not
- include a requirement to continue to provide support service,
- warranty, or updates for a work that has been modified or installed
- by the recipient, or for the User Product in which it has been
- modified or installed. Access to a network may be denied when the
- modification itself materially and adversely affects the operation
- of the network or violates the rules and protocols for
- communication across the network.
-
- Corresponding Source conveyed, and Installation Information
- provided, in accord with this section must be in a format that is
- publicly documented (and with an implementation available to the
- public in source code form), and must require no special password
- or key for unpacking, reading or copying.
-
- 7. Additional Terms.
-
- "Additional permissions" are terms that supplement the terms of
- this License by making exceptions from one or more of its
- conditions. Additional permissions that are applicable to the
- entire Program shall be treated as though they were included in
- this License, to the extent that they are valid under applicable
- law. If additional permissions apply only to part of the Program,
- that part may be used separately under those permissions, but the
- entire Program remains governed by this License without regard to
- the additional permissions.
-
- When you convey a copy of a covered work, you may at your option
- remove any additional permissions from that copy, or from any part
- of it. (Additional permissions may be written to require their own
- removal in certain cases when you modify the work.) You may place
- additional permissions on material, added by you to a covered work,
- for which you have or can give appropriate copyright permission.
-
- Notwithstanding any other provision of this License, for material
- you add to a covered work, you may (if authorized by the copyright
- holders of that material) supplement the terms of this License with
- terms:
-
- a. Disclaiming warranty or limiting liability differently from
- the terms of sections 15 and 16 of this License; or
-
- b. Requiring preservation of specified reasonable legal notices
- or author attributions in that material or in the Appropriate
- Legal Notices displayed by works containing it; or
-
- c. Prohibiting misrepresentation of the origin of that material,
- or requiring that modified versions of such material be marked
- in reasonable ways as different from the original version; or
-
- d. Limiting the use for publicity purposes of names of licensors
- or authors of the material; or
-
- e. Declining to grant rights under trademark law for use of some
- trade names, trademarks, or service marks; or
-
- f. Requiring indemnification of licensors and authors of that
- material by anyone who conveys the material (or modified
- versions of it) with contractual assumptions of liability to
- the recipient, for any liability that these contractual
- assumptions directly impose on those licensors and authors.
-
- All other non-permissive additional terms are considered "further
- restrictions" within the meaning of section 10. If the Program as
- you received it, or any part of it, contains a notice stating that
- it is governed by this License along with a term that is a further
- restriction, you may remove that term. If a license document
- contains a further restriction but permits relicensing or conveying
- under this License, you may add to a covered work material governed
- by the terms of that license document, provided that the further
- restriction does not survive such relicensing or conveying.
-
- If you add terms to a covered work in accord with this section, you
- must place, in the relevant source files, a statement of the
- additional terms that apply to those files, or a notice indicating
- where to find the applicable terms.
-
- Additional terms, permissive or non-permissive, may be stated in
- the form of a separately written license, or stated as exceptions;
- the above requirements apply either way.
-
- 8. Termination.
-
- You may not propagate or modify a covered work except as expressly
- provided under this License. Any attempt otherwise to propagate or
- modify it is void, and will automatically terminate your rights
- under this License (including any patent licenses granted under the
- third paragraph of section 11).
-
- However, if you cease all violation of this License, then your
- license from a particular copyright holder is reinstated (a)
- provisionally, unless and until the copyright holder explicitly and
- finally terminates your license, and (b) permanently, if the
- copyright holder fails to notify you of the violation by some
- reasonable means prior to 60 days after the cessation.
-
- Moreover, your license from a particular copyright holder is
- reinstated permanently if the copyright holder notifies you of the
- violation by some reasonable means, this is the first time you have
- received notice of violation of this License (for any work) from
- that copyright holder, and you cure the violation prior to 30 days
- after your receipt of the notice.
-
- Termination of your rights under this section does not terminate
- the licenses of parties who have received copies or rights from you
- under this License. If your rights have been terminated and not
- permanently reinstated, you do not qualify to receive new licenses
- for the same material under section 10.
-
- 9. Acceptance Not Required for Having Copies.
-
- You are not required to accept this License in order to receive or
- run a copy of the Program. Ancillary propagation of a covered work
- occurring solely as a consequence of using peer-to-peer
- transmission to receive a copy likewise does not require
- acceptance. However, nothing other than this License grants you
- permission to propagate or modify any covered work. These actions
- infringe copyright if you do not accept this License. Therefore,
- by modifying or propagating a covered work, you indicate your
- acceptance of this License to do so.
-
- 10. Automatic Licensing of Downstream Recipients.
-
- Each time you convey a covered work, the recipient automatically
- receives a license from the original licensors, to run, modify and
- propagate that work, subject to this License. You are not
- responsible for enforcing compliance by third parties with this
- License.
-
- An "entity transaction" is a transaction transferring control of an
- organization, or substantially all assets of one, or subdividing an
- organization, or merging organizations. If propagation of a
- covered work results from an entity transaction, each party to that
- transaction who receives a copy of the work also receives whatever
- licenses to the work the party's predecessor in interest had or
- could give under the previous paragraph, plus a right to possession
- of the Corresponding Source of the work from the predecessor in
- interest, if the predecessor has it or can get it with reasonable
- efforts.
-
- You may not impose any further restrictions on the exercise of the
- rights granted or affirmed under this License. For example, you
- may not impose a license fee, royalty, or other charge for exercise
- of rights granted under this License, and you may not initiate
- litigation (including a cross-claim or counterclaim in a lawsuit)
- alleging that any patent claim is infringed by making, using,
- selling, offering for sale, or importing the Program or any portion
- of it.
-
- 11. Patents.
-
- A "contributor" is a copyright holder who authorizes use under this
- License of the Program or a work on which the Program is based.
- The work thus licensed is called the contributor's "contributor
- version".
-
- A contributor's "essential patent claims" are all patent claims
- owned or controlled by the contributor, whether already acquired or
- hereafter acquired, that would be infringed by some manner,
- permitted by this License, of making, using, or selling its
- contributor version, but do not include claims that would be
- infringed only as a consequence of further modification of the
- contributor version. For purposes of this definition, "control"
- includes the right to grant patent sublicenses in a manner
- consistent with the requirements of this License.
-
- Each contributor grants you a non-exclusive, worldwide,
- royalty-free patent license under the contributor's essential
- patent claims, to make, use, sell, offer for sale, import and
- otherwise run, modify and propagate the contents of its contributor
- version.
-
- In the following three paragraphs, a "patent license" is any
- express agreement or commitment, however denominated, not to
- enforce a patent (such as an express permission to practice a
- patent or covenant not to sue for patent infringement). To "grant"
- such a patent license to a party means to make such an agreement or
- commitment not to enforce a patent against the party.
-
- If you convey a covered work, knowingly relying on a patent
- license, and the Corresponding Source of the work is not available
- for anyone to copy, free of charge and under the terms of this
- License, through a publicly available network server or other
- readily accessible means, then you must either (1) cause the
- Corresponding Source to be so available, or (2) arrange to deprive
- yourself of the benefit of the patent license for this particular
- work, or (3) arrange, in a manner consistent with the requirements
- of this License, to extend the patent license to downstream
- recipients. "Knowingly relying" means you have actual knowledge
- that, but for the patent license, your conveying the covered work
- in a country, or your recipient's use of the covered work in a
- country, would infringe one or more identifiable patents in that
- country that you have reason to believe are valid.
-
- If, pursuant to or in connection with a single transaction or
- arrangement, you convey, or propagate by procuring conveyance of, a
- covered work, and grant a patent license to some of the parties
- receiving the covered work authorizing them to use, propagate,
- modify or convey a specific copy of the covered work, then the
- patent license you grant is automatically extended to all
- recipients of the covered work and works based on it.
-
- A patent license is "discriminatory" if it does not include within
- the scope of its coverage, prohibits the exercise of, or is
- conditioned on the non-exercise of one or more of the rights that
- are specifically granted under this License. You may not convey a
- covered work if you are a party to an arrangement with a third
- party that is in the business of distributing software, under which
- you make payment to the third party based on the extent of your
- activity of conveying the work, and under which the third party
- grants, to any of the parties who would receive the covered work
- from you, a discriminatory patent license (a) in connection with
- copies of the covered work conveyed by you (or copies made from
- those copies), or (b) primarily for and in connection with specific
- products or compilations that contain the covered work, unless you
- entered into that arrangement, or that patent license was granted,
- prior to 28 March 2007.
-
- Nothing in this License shall be construed as excluding or limiting
- any implied license or other defenses to infringement that may
- otherwise be available to you under applicable patent law.
-
- 12. No Surrender of Others' Freedom.
-
- If conditions are imposed on you (whether by court order, agreement
- or otherwise) that contradict the conditions of this License, they
- do not excuse you from the conditions of this License. If you
- cannot convey a covered work so as to satisfy simultaneously your
- obligations under this License and any other pertinent obligations,
- then as a consequence you may not convey it at all. For example,
- if you agree to terms that obligate you to collect a royalty for
- further conveying from those to whom you convey the Program, the
- only way you could satisfy both those terms and this License would
- be to refrain entirely from conveying the Program.
-
- 13. Use with the GNU Affero General Public License.
-
- Notwithstanding any other provision of this License, you have
- permission to link or combine any covered work with a work licensed
- under version 3 of the GNU Affero General Public License into a
- single combined work, and to convey the resulting work. The terms
- of this License will continue to apply to the part which is the
- covered work, but the special requirements of the GNU Affero
- General Public License, section 13, concerning interaction through
- a network will apply to the combination as such.
-
- 14. Revised Versions of this License.
-
- The Free Software Foundation may publish revised and/or new
- versions of the GNU General Public 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.
-
- Each version is given a distinguishing version number. If the
- Program specifies that a certain numbered version of the GNU
- General Public License "or any later version" applies to it, you
- have the option of following the terms and conditions either of
- that numbered version or of any later version published by the Free
- Software Foundation. If the Program does not specify a version
- number of the GNU General Public License, you may choose any
- version ever published by the Free Software Foundation.
-
- If the Program specifies that a proxy can decide which future
- versions of the GNU General Public License can be used, that
- proxy's public statement of acceptance of a version permanently
- authorizes you to choose that version for the Program.
-
- Later license versions may give you additional or different
- permissions. However, no additional obligations are imposed on any
- author or copyright holder as a result of your choosing to follow a
- later version.
-
- 15. Disclaimer of Warranty.
-
- THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY
- APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE
- COPYRIGHT HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS"
- WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED,
- INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
- MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE
- RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU.
- SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL
- NECESSARY SERVICING, REPAIR OR CORRECTION.
-
- 16. Limitation of Liability.
-
- IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN
- WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES
- AND/OR CONVEYS THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR
- DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR
- CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE
- THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA
- BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD
- PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER
- PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF
- THE POSSIBILITY OF SUCH DAMAGES.
-
- 17. Interpretation of Sections 15 and 16.
-
- If the disclaimer of warranty and limitation of liability provided
- above cannot be given local legal effect according to their terms,
- reviewing courts shall apply local law that most closely
- approximates an absolute waiver of all civil liability in
- connection with the Program, unless a warranty or assumption of
- liability accompanies a copy of the Program in return for a fee.
-
-END OF TERMS AND CONDITIONS
-===========================
-
-How to Apply These Terms to Your New Programs
-=============================================
-
-If you develop a new program, and you want it to be of the greatest
-possible use to the public, the best way to achieve this is to make it
-free software which everyone can redistribute and change under these
-terms.
-
- To do so, attach the following notices to the program. It is safest
-to attach them to the start of each source file to most effectively
-state the exclusion of warranty; and each file should have at least the
-"copyright" line and a pointer to where the full notice is found.
-
- ONE LINE TO GIVE THE PROGRAM'S NAME AND A BRIEF IDEA OF WHAT IT DOES.
- Copyright (C) YEAR NAME OF AUTHOR
-
- This program is free software: you can redistribute it and/or modify
- it under the terms of the GNU General Public License as published by
- the Free Software Foundation, either version 3 of the License, or (at
- your option) any later version.
-
- This program is distributed in the hope that it will be useful, but
- WITHOUT ANY WARRANTY; without even the implied warranty of
- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
- General Public License for more details.
-
- You should have received a copy of the GNU General Public License
- along with this program. If not, see <https://www.gnu.org/licenses/>.
-
- Also add information on how to contact you by electronic and paper
-mail.
-
- If the program does terminal interaction, make it output a short
-notice like this when it starts in an interactive mode:
-
- PROGRAM Copyright (C) YEAR NAME OF AUTHOR
- This program comes with ABSOLUTELY NO WARRANTY; for details type 'show w'.
- This is free software, and you are welcome to redistribute it
- under certain conditions; type 'show c' for details.
-
- The hypothetical commands 'show w' and 'show c' should show the
-appropriate parts of the General Public License. Of course, your
-program's commands might be different; for a GUI interface, you would
-use an "about box".
-
- You should also get your employer (if you work as a programmer) or
-school, if any, to sign a "copyright disclaimer" for the program, if
-necessary. For more information on this, and how to apply and follow
-the GNU GPL, see <https://www.gnu.org/licenses/>.
-
- The GNU General Public License does not permit incorporating your
-program into proprietary programs. If your program is a subroutine
-library, you may consider it more useful to permit linking proprietary
-applications with the library. If this is what you want to do, use the
-GNU Lesser General Public License instead of this License. But first,
-please read <https://www.gnu.org/licenses/why-not-lgpl.html>.
-
-
-File: rt-liberation.info, Node: The GNU FDL, Next: Concept Index, Prev: Copying, Up: Top
-
-11 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.
-
-11.1 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.
-
-
-File: rt-liberation.info, Node: Concept Index, Next: Function Index, Prev: The GNU FDL, Up: Top
-
-Concept Index
-*************
-
-
-* Menu:
-
-* Batch Operations: Batch Operations. (line 6)
-* FDL, GNU Free Documentation License: The GNU FDL. (line 6)
-* Gnus Integration: Gnus Integration. (line 6)
-* installation: Installation. (line 6)
-* introduction: Introduction. (line 6)
-* Local Storage: Local Storage. (line 6)
-* queries: Queries. (line 6)
-* query compiler: Query Compiler. (line 6)
-* query language: Query Language. (line 6)
-* ticket browser: Ticket Browser. (line 6)
-* ticket browser display function: Ticket Browser Display.
- (line 6)
-* ticket browser filtering filter: Ticket Browser Filtering.
- (line 6)
-* ticket browser multiple buffer: Multiple Ticket Browsers.
- (line 6)
-* ticket browser sorting: Ticket Browser Sorting.
- (line 6)
-* ticket viewer: Ticket Viewer. (line 6)
-* Tracking Updates: Tracking Updates. (line 6)
-
-
-File: rt-liberation.info, Node: Function Index, Next: Variable Index, Prev: Concept Index, Up: Top
-
-Function Index
-**************
-
-
-* Menu:
-
-* revert-buffer: Ticket Browser. (line 48)
-* revert-buffer <1>: Ticket Viewer. (line 66)
-* rt-liber-browse-query: Ticket Browser. (line 12)
-* rt-liber-browser-ancillary-text: Local Storage. (line 22)
-* rt-liber-browser-assign: Ticket Browser. (line 62)
-* rt-liber-browser-mark-as-spam: Ticket Browser. (line 55)
-* rt-liber-browser-mode-quit: Ticket Browser. (line 36)
-* rt-liber-browser-move: Ticket Browser. (line 80)
-* rt-liber-browser-open: Ticket Browser. (line 68)
-* rt-liber-browser-prioritize: Ticket Browser. (line 83)
-* rt-liber-browser-refresh-and-return: Ticket Browser. (line 51)
-* rt-liber-browser-resolve: Ticket Browser. (line 65)
-* rt-liber-browser-take-ticket-at-point: Ticket Browser. (line 71)
-* rt-liber-display-ticket-at-point: Ticket Browser. (line 45)
-* rt-liber-jump-to-latest-correspondence: Ticket Viewer. (line 31)
-* rt-liber-lex-lessthan-p: Ticket Browser Sorting.
- (line 15)
-* rt-liber-mark-ticket-at-point: Batch Operations. (line 18)
-* rt-liber-multi-assign: Batch Operations. (line 27)
-* rt-liber-multi-delete-spam: Ticket Browser. (line 58)
-* rt-liber-multi-flag-as-spam-and-delete: Batch Operations. (line 30)
-* rt-liber-multi-set-status-open: Batch Operations. (line 21)
-* rt-liber-multi-set-status-resolved: Batch Operations. (line 24)
-* rt-liber-next-section-in-viewer: Ticket Viewer. (line 28)
-* rt-liber-next-ticket-in-browser: Ticket Browser. (line 39)
-* rt-liber-previous-section-in-viewer: Ticket Viewer. (line 34)
-* rt-liber-previous-ticket-in-browser: Ticket Browser. (line 42)
-* rt-liber-time-lessthan-p: Ticket Browser Sorting.
- (line 30)
-* rt-liber-update: Tracking Updates. (line 17)
-* rt-liber-viewer-answer: Ticket Viewer. (line 40)
-* rt-liber-viewer-answer-provisionally: Ticket Viewer. (line 48)
-* rt-liber-viewer-answer-provisionally-this: Ticket Viewer. (line 51)
-* rt-liber-viewer-answer-this: Ticket Viewer. (line 43)
-* rt-liber-viewer-answer-verbatim-this: Ticket Viewer. (line 56)
-* rt-liber-viewer-comment: Ticket Viewer. (line 60)
-* rt-liber-viewer-comment-this: Ticket Viewer. (line 63)
-* rt-liber-viewer-mode-quit: Ticket Viewer. (line 25)
-* rt-liber-viewer-show-ticket-browser: Ticket Viewer. (line 75)
-* rt-liber-viewer-visit-in-browser: Ticket Viewer. (line 37)
-* scroll-down: Ticket Browser. (line 77)
-* scroll-down <1>: Ticket Viewer. (line 72)
-* scroll-up: Ticket Browser. (line 74)
-* scroll-up <1>: Ticket Viewer. (line 69)
-
-
-File: rt-liberation.info, Node: Variable Index, Next: Keybinding Index, Prev: Function Index, Up: Top
-
-Variable Index
-**************
-
-
-* Menu:
-
-* rt-liber-gnus-address: Gnus Integration. (line 20)
-* rt-liber-gnus-comment-address: Gnus Integration. (line 24)
-* rt-liber-gnus-subject-name: Gnus Integration. (line 28)
-
-
-File: rt-liberation.info, Node: Keybinding Index, Prev: Variable Index, Up: Top
-
-Keybinding Index
-****************
-
-
-* Menu:
-
-* a (ticket browser): Ticket Browser. (line 62)
-* A (ticket browser): Local Storage. (line 22)
-* c (ticket viewer): Ticket Viewer. (line 60)
-* C (ticket viewer): Ticket Viewer. (line 63)
-* DEL (ticket browser): Ticket Browser. (line 77)
-* DEL (ticket viewer): Ticket Viewer. (line 72)
-* F (ticket viewer): Ticket Viewer. (line 56)
-* g (ticket browser): Ticket Browser. (line 48)
-* G (ticket browser): Ticket Browser. (line 51)
-* g (ticket viewer): Ticket Viewer. (line 66)
-* h (ticket viewer): Ticket Viewer. (line 75)
-* m (ticket browser): Ticket Browser. (line 80)
-* M (ticket browser): Batch Operations. (line 18)
-* m (ticket viewer): Ticket Viewer. (line 40)
-* M (ticket viewer): Ticket Viewer. (line 43)
-* n (ticket browser): Ticket Browser. (line 39)
-* n (ticket viewer): Ticket Viewer. (line 28)
-* N (ticket viewer): Ticket Viewer. (line 31)
-* o (ticket browser): Ticket Browser. (line 68)
-* p (ticket browser): Ticket Browser. (line 42)
-* P (ticket browser): Ticket Browser. (line 83)
-* p (ticket viewer): Ticket Viewer. (line 34)
-* q (ticket browser): Ticket Browser. (line 36)
-* q (ticket viewer): Ticket Viewer. (line 25)
-* r (ticket browser): Ticket Browser. (line 65)
-* RET (ticket browser): Ticket Browser. (line 45)
-* s (ticket browser): Ticket Browser. (line 55)
-* S (ticket browser): Ticket Browser. (line 58)
-* SPC (ticket browser): Ticket Browser. (line 74)
-* SPC (ticket viewer): Ticket Viewer. (line 69)
-* t (ticket browser): Ticket Browser. (line 71)
-* t (ticket viewer): Ticket Viewer. (line 48)
-* t (ticket viewer) <1>: Ticket Viewer. (line 51)
-* V (ticket viewer): Ticket Viewer. (line 37)
-
-
-
-Tag Table:
-Node: Top698
-Node: Introduction2979
-Node: Installation3591
-Node: Queries4575
-Node: Query Compiler5142
-Node: Query Language5788
-Node: Ticket Browser8232
-Node: Ticket Browser Display10709
-Node: Ticket Browser Sorting12705
-Node: Ticket Browser Filtering14660
-Node: Multiple Ticket Browsers16208
-Node: Ticket Viewer17382
-Node: Gnus Integration19559
-Node: Tracking Updates21852
-Node: Batch Operations22934
-Node: Local Storage24119
-Node: Copying25202
-Node: The GNU FDL62756
-Node: Concept Index85153
-Node: Function Index86739
-Node: Variable Index90094
-Node: Keybinding Index90475
-
-End Tag Table