\input texinfo
@comment %**start of header
-@setfilename ../../info/htmlfontify
+@setfilename ../../info/htmlfontify.info
@settitle Htmlfontify User Manual
@exampleindent 2
+@documentencoding UTF-8
@comment %**end of header
@copying
This manual documents Htmlfontify, a source code -> crosslinked +
-formatted + syntax colorised html transformer.
+formatted + syntax colorized html transformer.
-Copyright @copyright{} 2002, 2003, 2013 Free Software Foundation, Inc.
+Copyright @copyright{} 2002-2003, 2013-2014 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.3 or
any later version published by the Free Software Foundation; with no
-Invariant Sections, with the Front-Cover texts being ``A GNU Manual,''
+Invariant Sections, with the Front-Cover Texts being ``A GNU Manual,''
and with the Back-Cover Texts as in (a) below. A copy of the license
is included in the section entitled ``GNU Free Documentation License''.
@dircategory Emacs misc features
@direntry
-* Htmlfontify: (htmlfontify). Convert source code to html.
+* Htmlfontify: (htmlfontify). Convert source code to html.
@end direntry
@titlepage
@menu
* Introduction:: About Htmlfontify.
* Usage & Examples:: How to use Htmlfontify.
-* Customisation:: Fine-tuning Htmlfontify's behaviour.
+* Customization:: Fine-tuning Htmlfontify's behavior.
* Requirements:: External programs used by Htmlfontify.
* GNU Free Documentation License:: The license for this documentation.
* Index:: Index of contents.
Htmlfontify provides a means of converting individual Emacs buffers,
source files, or entire source trees to html, preserving formatting
-and Emacs colorisation / syntax highlighting as much as possible
+and Emacs colorization / syntax highlighting as much as possible
through careful application of CSS stylesheets and html tags.
It can also turn instances of functions, methods and (for some
to their definitions, and create an index file (or files) of
all such symbols, also linked to their points of definition.
-Htmlfontify also provides several customisation items, which should
+Htmlfontify also provides several customization items, which should
allow it to mesh more-or-less seamlessly with various templating or
publishing systems (in the event, for instance, that you don't want
to produce the html pages directly).
@menu
* Interactive:: Using Htmlfontify interactively.
* Non-interactive:: Using Htmlfontify from elisp.
-* Variables:: Variables (other than customisation entries).
+* Variables:: Variables (other than customization entries).
* Data Structures:: Important data structures.
* Examples:: Example(s) of Htmlfontify in use.
@end menu
entities, so you should even be able to do html-within-html fontified
display.
-You should, however, note that random control or eight-bit characters
-such as ^L (\x0c) or ¤ (\xa4) won't get mapped yet.
+You should, however, note that random control or non-ASCII characters
+such as ^L (\x0c) or ¤ (\xa4) won't get mapped yet.
If the @var{srcdir} and @var{file} arguments are set, lookup etags
derived entries in the @ref{hfy-tags-cache} and add html anchors
@end lisp
Return a @code{defface} style alist of possible specifications for
-@var{face}, with any entries resulting from user customisation
+@var{face}, with any entries resulting from user customization
(@code{custom-set-faces}) taking precedence.
See also: @ref{hfy-default-face-def}
exposed and rendered, or until Emacs is idle for a while. Sometimes, in
non-interactive circumstances, or if it can't see X, it doesn't bother
with some of the harder stuff. While this is all great from the perspective
-of a user waiting for Emacs to load a 20000 line file and colorise it,
+of a user waiting for Emacs to load a 20000 line file and colorize it,
it's a pain from the point of view from non-interactive code. This function
lies, cheats, steals and generally bullies Emacs into fontifying a buffer
-from start to finish, with all the extra frills, whether it thinks it nneds
+from start to finish, with all the extra frills, whether it thinks it needs
to or not. Oh yes: it operates on the current buffer.
@item hfy-link-style-string
@end lisp
Given @var{props}, a list of text-properties, return the value of the
-face property, or nil.
+face property, or @code{nil}.
@item hfy-box-to-border-assoc
@findex hfy-box-to-border-assoc
from 0.18 onwards, each font attribute list is scored, and the
non-conflicting list with the highest score is returned. (A specification
with a class of @code{t} is considered to match any class you specify.
-This matches Emacs's behaviour when deciding on which face attributes to
+This matches Emacs's behavior when deciding on which face attributes to
use, to the best of my understanding ).
-If @var{class} is nil, then you just get get whatever
+If @var{class} is @code{nil}, then you just get get whatever
@code{face-attr-construct} returns; i.e., the current specification in
effect for @var{face}.
(hfy-kludge-cperl-mode)
@end lisp
-cperl mode does its damndest not to do some of its fontification when not
+cperl mode does its best to not do some of its fontification when not
in a windowing system---we try to trick it@dots{}
@item hfy-href
@section Variables
@cindex variables
-Important variables that are not customisation items:
+Important variables that are not customization items:
@table @code
;; Here's the function I actually call---it asks me for a section label,
;; and source and destination directories, and then binds a couple of
-;; customisation variable in a let before calling htmlfontify:
+;; customization variable in a let before calling htmlfontify:
(defun rtfm-build-source-docs (section srcdir destdir)
(interactive
"s section[eg- emacs / p4-blame]:\nD source-dir: \nD output-dir: ")
(htmlfontify-copy-and-link-dir srcdir destdir ".src" ".html")))
@end lisp
-@node Customisation
-@chapter Customisation
-@cindex variables (customisation)
+@node Customization
+@chapter Customization
+@cindex variables (customization)
-Htmlfontify provides the following variable and customisation entries:
+Htmlfontify provides the following variable and customization entries:
@table @code
@comment AUTOGENERATED BLOCK
@vindex hfy-html-quote-regex
@anchor{hfy-html-quote-regex}
+@c FIXME: the cross-reference below looks ugly
Regex to match (with a single back-reference per match) strings in HTML
which should be quoted with @ref{hfy-html-quote}
(and @pxref{hfy-html-quote-map}) to make them safe.
String to add to the @samp{<style> a} variant of an Htmlfontify CSS class.
-@item hfy-fast-lock-save
-@vindex hfy-fast-lock-save
-@anchor{hfy-fast-lock-save}
-
-Minimum size of a buffer for cached fontification.
-This value is temporarily assigned to @code{fast-lock-minimum-size} during
-html-fontification.
-
-Only buffers more than this can have associated Font Lock cache files saved.
-
-If nil, means cache files are never created.
-
-If a list, each element should be a cons pair of the form
-@code{(@var{major-mode} . @var{size})}, where @var{major-mode}
-is a symbol or t (meaning the default). For example:
-
-@lisp
- ((c-mode . 25600 )
- (c++-mode . 25600 )
- (rmail-mode . 1048576))
-@end lisp
-
-means that the minimum size is 25K for buffers in C or C++ modes, one megabyte
-for buffers in Rmail mode, and size is irrelevant (i.e., no saves) otherwise.
-
@item hfy-split-index
@vindex hfy-split-index
@anchor{hfy-split-index}
@vindex hfy-extn
@anchor{hfy-extn}
-File extension used for output files
+File extension used for output files.
@item hfy-default-face-def
@vindex hfy-default-face-def
extracting potentially non-current face information doesn't necessarily
work for @code{default}).
-For example, I customise this to:
+For example, I customize this to:
@lisp
((t :background "black" :foreground "white" :family "misc-fixed"))
@anchor{hfy-init-kludge-hooks}
List of functions to call when starting htmlfontify-buffer to do any
-kludging necessary to get highlighting modes to bahave as you want, even
+kludging necessary to get highlighting modes to behave as you want, even
when not running under a window system.
@item hfy-shell-file-name
@vindex hfy-optimisations
@anchor{hfy-optimisations}
-Optimisations to turn on. So far, the following have been implemented:
+Optimizations to turn on. So far, the following have been implemented:
@table @option
@item merge-adjacent-tags
@end table
-Note: like compiler optimisations, these optimise the _output_ of the code,
+Note: like compiler optimizations, these optimize the @emph{output} of
+the code,
not the processing of the source itself, and are therefore likely to slow
Htmlfontify down, at least a little. Except for skip-refontification,
which can never slow you down, but may result in incomplete fontification.
@vindex hfy-src-doc-link-unstyle
@anchor{hfy-src-doc-link-unstyle}
-Regex to remove from the <style> a variant of an Htmlfontify CSS class.
+Regex to remove from the @samp{<style> a} variant of an Htmlfontify CSS class.
@item hfy-link-extn
@vindex hfy-link-extn
@anchor{hfy-link-extn}
File extension used for href links---useful where the Htmlfontify
-output files are going to be processed again, with a rersulting change
+output files are going to be processed again, with a resulting change
in file extension. If @code{nil}, then any code using this should fall back
to @ref{hfy-extn}.
in order, to:
@enumerate
- The tag
- The line
- The character (point) at which the tag occurs
+@item
+The tag
+@item
+The line
+@item
+The character (point) at which the tag occurs
@end enumerate
@item hfy-index-file
@item
A copy of etags (exuberant-ctags or GNU etags). Htmlfontify attempts
-to autodetect the version you have and customise itself accordingly,
+to autodetect the version you have and customize itself accordingly,
but you should be able to override this.
-See: @ref{Customisation}
+See: @ref{Customization}
@item
A copy of find (e.g., GNU find) that provides the @code{-path} predicate.
You may be able to work around this with a suitable clever shell
-command and the customisation entry: @ref{hfy-find-cmd}
+command and the customization entry: @ref{hfy-find-cmd}
@item
A copy of sed (e.g., GNU sed).
@item Functions
@printindex fn
-@item Variables & Customisation
+@item Variables & Customization
@printindex vr
@end table
@setchapternewpage odd
@bye
+
+@c Local Variables:
+@c coding: utf-8
+@c End: