Rewrite manuals for feh-cam and gen-cam-menu

3 files changed, 69 insertions, 34 deletions

diff --git a/Makefile b/Makefile
index a409c36..f2ca42f 100644
--- a/Makefile
+++ b/Makefile
@@ -8,9 +8,9 @@ install: install-man install-doc install-bin install-font install-img
 install-man:
 	@echo installing manuals to ${man_dir}
 	@mkdir -p ${man_dir}/man1
-	@cp man/feh.1 man/feh-cam.1 ${man_dir}/man1
-	@chmod 644 $(man_dir)/man1/feh.1 $(man_dir)/man1/feh-cam.1
-	@ln -fs feh-cam.1 $(man_dir)/man1/gen-cam-menu.1
+	@cp man/feh.1 man/feh-cam.1 man/gen-cam-menu.1 ${man_dir}/man1
+	@chmod 644 ${man_dir}/man1/feh.1 ${man_dir}/man1/feh-cam.1 \
+		${man_dir}/man1/gen-cam-menu.1
 
 install-doc:
 	@echo installing docs to ${doc_dir}
diff --git a/man/feh-cam.1 b/man/feh-cam.1
index dcd3f07..a8b01f3 100644
--- a/man/feh-cam.1
+++ b/man/feh-cam.1
@@ -1,31 +1,45 @@
-.TH feh-cam 1 "29 Oct 2000" "feh-cam"
-.SH NAME
-.HP
-feh-cam - a utility for viewing live webcam images
-.HP
-gen-cam-menu - a utility for updating Enlightenment user 
-menus for feh-cam.
-.SH SYNOPSIS
-.HP
-feh-cam [options]
-.P
-.SH DESCRIPTION
-.HP
-.I feh-cam
-is a Perl wrapper for feh that simplifies viewing webcams.
-feh-cam uses keyed bookmarks. It helps manage viewing your
-favorite webcam sites with feh.
-.HP
-.I gen-cam-menu
-is a shell script that creates Enlightenment user menu entries
-in $HOME/.enlightenment/.
-.HP
-Type
-.I "feh-cam -h"
-at a command line for usage information.
-.P
-.SH AUTHORS
-This manual page was written by <unknown> for the Debian project.
-.SH SEE ALSO
-.HP
-feh(1)
+.Dd April 12, 2010
+.Dt FEH-CAM 1
+.Os
+.
+.Sh NAME
+.Nm feh-cam
+.Nd utility for viewing live webcam images
+.Sh SYNOPSIS
+.Nm
+.Op Ar options
+.Ar keys
+.
+.Sh DESCRIPTION
+.Nm
+is a perl wrapper for feh which simplifies viewing webcams using keyed
+bookmarks.  It helps manage viewing your favourite webcam sites with feh.
+.
+.Sh OPTIONS
+.Bl -tag -width indent
+.It Cm -a , --add Ar key url refresh
+Add
+.Ar url
+as
+.Ar key
+to the bookmarks file; when viewing, reload it every
+.Ar refresh
+seconds
+.It Cm -l , --list
+List each url / key pair in the bookmarks file
+.It Cm -f , --full-screen
+Start feh in full-screen mode
+.It Cm -k , --keep-images
+Save each webcam image in the current directory
+.It Cm -g , --geometry Ar width No x Ar height
+Use window geometry
+.Ar width No x Ar height
+.It Cm -v , --verbose
+Start feh in verbose mode
+.El
+.
+.Sh FILES
+The bookmarks are stored in
+.Pa ~/.cam_bookmarks
+.Sh SEE ALSO
+.Xr feh 1
diff --git a/man/gen-cam-menu.1 b/man/gen-cam-menu.1
new file mode 100644
index 0000000..c8929eb
--- /dev/null
+++ b/man/gen-cam-menu.1
@@ -0,0 +1,21 @@
+.Dd April 12, 2010
+.Dt GEN-CAM-Menu 1
+.Os
+.
+.Sh NAME
+.Nm gen-cam-menu
+.Nd utility for updating Enlightenment user menus for feh-cam
+.Sh SYNOPSIS
+.Nm
+.
+.Sh DESCRIPTION
+.Nm
+is a shell script which creates Enlightenment user menu entries for the
+bookmarks stored by
+.Xr feh-cam 1
+in
+.Pa ~/.enlightenment/ .
+.
+.Sh SEE ALSO
+.Xr feh 1 ,
+.Xr feh-cam 1