.\"  $HeadURL$ $LastChangedRevision$
.TH ABM 1 "ADE_APP_TOKEN_RELEASE_DATE_MAN"
.ne 5
.SH NAME
abm \- add web bookmark
.br
.ne 5
.SH SYNOPSIS
.B abm 
[
.B \-V
|
.B \-\-version
] [
.B \-v
|
.B \-\-verbose
|
.B \-d
.I level
|
.B \-\-debug=\fIlevel
] [
.B \-h
|
.B \-\-help
] [
.B \-p
|
.B \-\-list\-paths
] 
[
.B \-b 
.I dir
|
.B \-\-bookmarks\-dir=\fIdir
] 
.I url
.br
.ne 5
.SH DESCRIPTION
.B Abm
is a small script for adding a bookmark for 
.I url
to a portable hierarchy of HTML bookmarks.
.PP
The bookmarks are stored one per file, and each file is 
written in HTML. The HTML code in each file redirects the 
browser to 
.I url\fR.
.ne 5
.SH CONFIGURATION
Create a new directory where you will store your bookmarks,
and assign its path the environment variable 
.B ABM_BOOKMARKS_DIR\fR.
.br
.ne 5
.SH OPTIONS
.TP 25
.B \-b \fIdir\fR, \fB\-\-bookmarks\-dir=\fIdir\fR
The bookmarks directory can be specified on the command line
with this option, but it is more convenient to specify it
with the environment variable.
.TP
.B \-d \fIlevel\fR, \fB\-\-debug=\fIlevel\fR
Determines how verbose
.B abm
will be. The message types displayed for the different values of 
.I level
are as follows:
.RS 25
.TP 5
.B 0
internal errors only
.TP
.B 1
internal errors and normal errors 
.TP
.B 2
internal errors, normal errors and warnings
.TP 
.B 3
internal errors, normal errors, warnings and informational messages
.TP 
.B >3
all the above plus application-specific debug messages.
.RE
.TP 25
.B \-h\fR, \fB\-\-help
Displays a brief usage message.
.TP
.B \-p\fR, \fB\-\-list\-paths
List the compiled-in paths of various files and directories that
.B abm
uses.
.TP 
.B \-v\fR, \fB\-\-verbose
Equivalent to
.B \-d 3\fR.
.TP
.B \-V\fR, \fB\-\-version
Print the program's version number and exit.
.br
.ne 5
.SH EXIT STATUS
On success
.B abm
returns zero. On failure it returns non-zero and displays a diagnostic
message.
.br
.ne 5
.SH FILES
None (other than the bookmarks).
.br
.ne 5
.SH ENVIRONMENT VARIABLES
.TP 25
.B ABM_BOOKMARKS_DIR
This specifies the directory where the bookmarks will be stored.
.br
.ne 5
.SH EXAMPLES
The following commands initialise a directory for bookmarks, set
up the environment (for 
.B sh\fR(1)),
add a bookmark and then view the tree with
.B lynx\fR(1):
.IP
.nf
.fam C
.B mkdir $HOME/doc/bookmarks
.B ABM_BOOKMARKS_DIR=$HOME/doc/bookmarks
.B export ABM_BOOKMARKS_DIR
.B abm http://www.google.com
*  <New Category or Bookmark>
Choice []: \fBSearch Engines\fR
Is that new category (c) or new bookmark (b) [b]: \fBc\fR
*  <New Category or Bookmark>
.B Google
Is that new category (c) or new bookmark (b) [b]:
.B lynx file://$ABM_BOOKMARKS_DIR
.fam T
.fi
.br
.ne 5
.SH CAVEATS
None.
.br
.ne 5
.SH STANDARDS
This manual page documents version ADE_APP_TOKEN_RELEASE_ID of
.B abm\fR.
.br
.ne 5
.SH SEE ALSO
lynx(1), sh(1)
.br
.ne 5
.SH AUTHOR
ADE_APP_TOKEN_AUTHOR_NAME <ADE_APP_TOKEN_AUTHOR_EMAIL>
.br
.ne 5
.SH COPYRIGHT & DISTRIBUTION POLICY
Copyright (C) 2001-ADE_APP_TOKEN_RELEASE_YEAR ADE_APP_TOKEN_AUTHOR_NAME
.PP
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 2 of the License, or
(at your option) any later version.
.PP
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.
.PP
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.