rpms/AGReader/devel agr.1,NONE,1.1 AGReader.spec,1.4,1.5

[Ian Chapman (oddsocks)]

Author: oddsocks

Update of /cvs/extras/rpms/AGReader/devel
In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv12093

Modified Files:
	AGReader.spec 
Added Files:
	agr.1 
Log Message:



--- NEW FILE agr.1 ---
.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 at 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.

Index: AGReader.spec
===================================================================
RCS file: /cvs/extras/rpms/AGReader/devel/AGReader.spec,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -r1.4 -r1.5
--- AGReader.spec	21 Aug 2007 19:47:44 -0000	1.4
+++ AGReader.spec	12 Oct 2007 23:19:56 -0000	1.5
@@ -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 @@
 %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 @@
 %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 at 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 at 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 at 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 at 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 at 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 @@
 - 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 at 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 at 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 at 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 at 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 at 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 at 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.