*** empty log message ***

AGReader.spec

@@ -1,11 +1,12 @@
 Name:           AGReader
 Version:        1.2
-Release:        3%{?dist}
+Release:        4%{?dist}
 Summary:        Console reader for viewing AmigaGuide files
 Group:          Applications/Text
 License:        GPL+
 URL:            http://main.aminet.net/misc/unix/
 Source0:        http://main.aminet.net/misc/unix/%{name}.tar.bz2
+Source1:        agr.1
 BuildRoot:      %{_tmppath}/%{name}-%{version}-%{release}-root-%(%{__id_u} -n)
 
 %description
@@ -25,6 +26,8 @@ make -C Sources %{?_smp_mflags} CFLAGS="$RPM_OPT_FLAGS"
 %install
 rm -rf %{buildroot}
 mkdir -p %{buildroot}%{_bindir}
+mkdir -p %{buildroot}%{_mandir}/man1
+install -m0644 %{SOURCE1} %{buildroot}%{_mandir}/man1
 install -m0755 Sources/agr %{buildroot}%{_bindir}
 
 
@@ -35,30 +38,34 @@ rm -rf %{buildroot}
 %files
 %defattr(-,root,root,-)
 %{_bindir}/agr
+%{_mandir}/man1/agr.1.gz
 %doc Docs/agr.guide Docs/test.guide Docs/agr.html README
 
 
 %changelog
-* Wed Aug 21 2007 Ian Chapman <packages@amiga-hardware.com> 1.2-3
+* Sat Oct 13 2007 Ian Chapman <packages[AT]amiga-hardware.com> 1.2-4
+- Added man page
+
+* Tue Aug 21 2007 Ian Chapman <packages[AT]amiga-hardware.com> 1.2-3
 - Release bump for F8 mass rebuild
 - License change due to new guidelines
 - A few cosmetic cleanups of the spec file
 
-* Mon Aug 28 2006 Ian Chapman <packages@amiga-hardware.com> 1.2-2
+* Mon Aug 28 2006 Ian Chapman <packages[AT]amiga-hardware.com> 1.2-2
 - Release bump for FC6 mass rebuild
 
-* Mon Jun 05 2006 Ian Chapman <packages@amiga-hardware.com> 1.2-1
+* Mon Jun 05 2006 Ian Chapman <packages[AT]amiga-hardware.com> 1.2-1
 - Version bump
 - Dropped patches, they are no longer required
 - Changed URL to use primary site, rather than a mirror
 
-* Sun May 28 2006 Ian Chapman <packages@amiga-hardware.com> 1.1-9
+* Sun May 28 2006 Ian Chapman <packages[AT]amiga-hardware.com> 1.1-9
 - Updated keys patch which fixes the keys under BOTH the console and an
   xterm, courtesy of Hans de Goede
 - Added provides to offer lower case alias in preparation for probable
   policy change
 
-* Sat May 27 2006 Ian Chapman <packages@amiga-hardware.com> 1.1-8.iss
+* Sat May 27 2006 Ian Chapman <packages[AT]amiga-hardware.com> 1.1-8.iss
 - Added patch to fix compilation with gcc41 courtesy of Hans de Goede
 - Added patch to fix Home, End, F1, F2, F3 keys courtesy of Hans de Goede
 - Added rpmoptflags to make line
@@ -66,23 +73,23 @@ rm -rf %{buildroot}
 - Use %%{?dist} for most recent changelog entry - avoids incoherent changelog
   versions if %%{?dist} macro is missing or different.
 
-* Sat May 13 2006 Ian Chapman <packages@amiga-hardware.com> 1.1-7.iss
+* Sat May 13 2006 Ian Chapman <packages[AT]amiga-hardware.com> 1.1-7.iss
 - Removed gcc32 patch. It's now specified on the make command line
 - Replaced %%{__rm} in clean section with rm
 
-* Mon May 01 2006 Ian Chapman <packages@amiga-hardware.com> 1.1-6.iss
+* Mon May 01 2006 Ian Chapman <packages[AT]amiga-hardware.com> 1.1-6.iss
 - Altered spec file to more closely follow Fedora build guidelines
 
-* Tue Oct 25 2004 Ian Chapman <packages@amiga-hardware.com> 1.1-5.iss
+* Tue Oct 25 2004 Ian Chapman <packages[AT]amiga-hardware.com> 1.1-5.iss
 - Fixes for deprecated fields with the latest version of rpmbuild
 
-* Thu Dec 04 2003 Ian Chapman <packages@amiga-hardware.com> 1.1-4
+* Thu Dec 04 2003 Ian Chapman <packages[AT]amiga-hardware.com> 1.1-4
 - Minor fixes to changelog
 - Fixed permissions on documentation directory
 - Changed group to Applications/Text
 
-* Sun Oct 05 2003 Ian Chapman <packages@amiga-hardware.com> 1.1-3
+* Sun Oct 05 2003 Ian Chapman <packages[AT]amiga-hardware.com> 1.1-3
 - Minor fixes to prep and clean
 
-* Fri Jul 18 2003 Ian Chapman <packages@amiga-hardware.com> 1.1-2
+* Fri Jul 18 2003 Ian Chapman <packages[AT]amiga-hardware.com> 1.1-2
 - Fixed few harmless bugs in SPEC file. Improved use of Macros.

agr.1

@@ -0,0 +1,119 @@
+.TH "agr" 1
+.SH NAME
+agr \- Displays AmigaGuide files in a terminal
+.SH SYNOPSIS
+.B agr
+.I guidefile
+.SH DESCRIPTION
+AmigaGuide Reader (\fBagr\fR for short) is a command line program for viewing
+AmigaGuide files, the native documentation format commonly used on the Amiga
+platform and its clones. It supports the complete v39 specification and a
+significant part of the v40 specification. AmigaGuide files traditionally use
+the .guide filename suffix.
+.SH OPTIONS
+.TP
+None
+.SH USAGE
+.PP
+In summary, \fBagr\fR primarily uses the TAB, CURSOR, SPACE and RETURN keys for
+navigation. An exhaustive list follows.
+.IP "q or ^C"
+Quits \fBagr\fR.
+.IP "CURSOR keys or i,j,k,l"
+Scroll the document up, down, left or right in cases where it is wider or
+longer than your terminal
+.IP "PAGE UP/PAGE DOWN"
+Scrolls the document up or down by one complete page, equal to the height of
+your terminal.
+.IP "HOME or g"
+Jumps to the top of the document node.
+.IP "END or G"
+Jumps to the bottom of the document node.
+.IP "SPACE or RETURN"
+Display the highlighted document node link.
+.IP "TAB"
+Highlight the next visible node link.
+.IP "a"
+Highlight the previous visible node link.
+.IP "F1"
+Display the Help Node if the AmigaGuide file has one defined. If you are using a
+terminal emulator under \fBX\fR(1), it may trap this key rendering it unavailable.
+.IP "F2"
+Display the Index Node if the AmigaGuide file has one defined.
+.IP "F3"
+Display the Table of Contents Node if the AmigaGuide file has one defined.
+.IP "n/b"
+Display the next  or previous document node. Please note, the next or previous
+document node does not follow the logical layout of the AmigaGuide document as
+it is displayed, but refers to the next or previous document node as
+sequentially written in the AmigaGuide file.
+.IP "+/-"
+Increase or decrease the TAB size (tabstop) by the equivalent of one space.
+.IP "t"
+Display the current TAB size (tabstop) in the lower right hand corner.
+.IP "r"
+Refresh the display.
+.IP "?"
+Display any meta data stored in the AmigaGuide file.
+.IP "v"
+Displays the contents of any broken links.
+.IP "="
+Displays the current line number in the lower right hand corner.
+.IP "C"
+Attempt to use native Amiga colouring for coloured text.
+.sp
+ANSI colours on the Amiga are not standardised but depend upon the current
+colourmap and palette in use. Thus if the user changes the colours used by
+their desktop environment, the ANSI colours change too. This command attempts
+to convert the colours displayed in \fBagr\fR from standard ANSI colours to
+those one would see by default on AmigaOS 2.0+. See the conversion table below.
+.RS
+.IP "Colour Table"
+#: ANSI       Amiga
+.br
+------------------------
+.br
+0: Black   -> Light Grey
+.br
+1: Red     -> Black
+.br
+2: Green   -> White
+.br
+3: Yellow  -> Light Blue
+.br
+4: Blue    -> Yellow
+.br
+5: Magenta -> Blue
+.br
+6: Cyan    -> Green
+.br
+7: White   -> Red
+.SH AUTHOR
+.PP
+Written by Thierry Pierron.
+.br
+Additional patches by Hans de Goede.
+.br
+This man page was written by Ian Chapman.
+.SH BUGS
+.PP
+Does not support the complete v40 specification.
+.br
+AREXX node links are not supported (rarely used feature).
+.br
+System command node links are not supported (rarely used feature).
+.PP
+This software is not actively updated, but patches or bug fixes are welcome and
+should be sent to <packages@amiga\-hardware.com>.
+.SH CAVEATS
+.PP
+Amiga filepaths are similar but differ slightly from UNIX file paths. In some
+cases this may lead to external files referenced by the AmigaGuide file as not
+being found. However \fBagr\fR tries several techniques to avoid this.
+.PP
+Amiga filenames are case insensitive so unless the correct case has been used
+in the AmigaGuide file, externally referenced files may not be found.
+.SH "SEE ALSO"
+.PP
+The full documentation for \fBagr\fR is available as an HTML file in addition to an
+AmigaGuide file which should have been installed alongside agr.