\input texinfo   @c -*-texinfo-*-
@comment $Id: Charmap.texi,v 1.3 2004/05/04 19:33:31 crculver Exp $
@comment %**start of header
@setfilename Charmap.info
@include version.texi
@settitle Guide to the Charmap application @value{CHARMAP-VERSION}
@documentlanguage en
@comment %**end of header

@setcontentsaftertitlepage
@smallbook
@setchapternewpage odd

@ifinfo
This manual is for Charmap (version @{value{CHARMAP-VERSION}), a
powerful character map. This manual documents the GNUstep version.

Copyright @copyright{}  2004 Christopher Culver.

Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.1 or
any later version published by the Free Software Foundation.
@end ifinfo

@copying
This manual is for Charmap
(version @value{CHARMAP-VERSION}), a powerful character map.
Copyright @copyright{} 2004 Christopher Culver
@quotation
Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.1 or
any later version published by the Free Software Foundation.
@end quotation
@end copying
@dircategory Texinfo documentation system
@direntry
* Charmap: a powerful character map.
@end direntry
@titlepage
@title Guide to the Charmap application
@subtitle for version @value{CHARMAP-VERSION}
@author Christopher Culver (@email{crculver@@users.sourceforge.net})
@page
@vskip 0pt plus 1filll
@insertcopying
@end titlepage
@contents
@ifnottex
@top Charmap
@insertcopying
@end ifnottex
@c @menu
@c * Acknowledgements::
@c * News::
@c * Installation::        How to build and install Charmap.
@c * Using Charmap::
@c * Copying::         GNU General Public License says how you can
@c copy and share GCC.
@c * GNU Free Documentation License:: How you can copy and share this manual.
@c * Index::
@c @end menu
@unnumbered Acknowledgements
@include thanks.texi
@chapter News
@include news.texi
@chapter Installing Charmap
@include install.texi
@chapter Using Charmap

@section Main Window

Charmap's main window consists of four parts.

@image{MainWindow, 457pt, 279pt}

@subsection Blocks Browser

The Blocks Browser (top left) provides a selection of Unicode
blocks.

@subsection Character Map Matrix

The Character Map Matrix (top right) shows all characters in the Unicode block
selected. Cells that are grayed-out represent positions not yet
assigned a character in Unicode.

Selecting a character and double-clicking it will place it
in the selection field (bottom left).

@subsection Selection Field

The Selection Field holds all characters selected from the Character
Map Matrix as well as any directly typed in by the user.

@subsection Copy Button

Clicking the Copy button (bottom right) will copy the text in the
selection to the pasteboard.

@section Character Inspector

@image{Inspector, 115.49pt, 111pt}

The Character Inspector, accessible from the menu item
``Inspector...'' provides detailed information on the character
currently selected in the Character Map Matrix.

@itemize @bullet
@item Name @*
The name of the character as presented in the Unicode standard
version 4.0.
@item Alias @*
The name of the character as presented in the Unicode standard version
1.0
@item Unicode Category @*
The category of the character, such as ``Letter, Uppercase'' or
``Mark, Non-spacing''.
@item Canonical Decomposition @*
When a precomposed character is selected, shows how the same character
can be constructed using a base and added combining characters.

@item Various Useful Representations @*
Numerical representations of a Unicode character that might be used when
the character can not be directly typed.
@itemize @minus
@item
UTF-8: The character as a series of 8-bit hexadecimal values.
@item
Octal-escaped UTF-8: The character as a series of 8-bit octal values. 
@item
Decimal entity reference: The representation of the character
which can be used in HTML and XML.
@end itemize

@end itemize

@node Copying

@include gpl.texi

@node  GNU Free Documentation License

@include fdl.texi

@bye

