From fcbe9fb152146354928115f2cf2b1f4aa1a9e1ff Mon Sep 17 00:00:00 2001 From: oddsocks Date: Oct 12 2007 23:19:56 +0000 Subject: *** empty log message *** --- diff --git a/AGReader.spec b/AGReader.spec index 75ed037..cd5c851 100644 --- a/AGReader.spec +++ b/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 1.2-3 +* Sat Oct 13 2007 Ian Chapman 1.2-4 +- Added man page + +* Tue Aug 21 2007 Ian Chapman 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 1.2-2 +* Mon Aug 28 2006 Ian Chapman 1.2-2 - Release bump for FC6 mass rebuild -* Mon Jun 05 2006 Ian Chapman 1.2-1 +* Mon Jun 05 2006 Ian Chapman 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 1.1-9 +* Sun May 28 2006 Ian Chapman 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 1.1-8.iss +* Sat May 27 2006 Ian Chapman 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 1.1-7.iss +* Sat May 13 2006 Ian Chapman 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 1.1-6.iss +* Mon May 01 2006 Ian Chapman 1.1-6.iss - Altered spec file to more closely follow Fedora build guidelines -* Tue Oct 25 2004 Ian Chapman 1.1-5.iss +* Tue Oct 25 2004 Ian Chapman 1.1-5.iss - Fixes for deprecated fields with the latest version of rpmbuild -* Thu Dec 04 2003 Ian Chapman 1.1-4 +* Thu Dec 04 2003 Ian Chapman 1.1-4 - Minor fixes to changelog - Fixed permissions on documentation directory - Changed group to Applications/Text -* Sun Oct 05 2003 Ian Chapman 1.1-3 +* Sun Oct 05 2003 Ian Chapman 1.1-3 - Minor fixes to prep and clean -* Fri Jul 18 2003 Ian Chapman 1.1-2 +* Fri Jul 18 2003 Ian Chapman 1.1-2 - Fixed few harmless bugs in SPEC file. Improved use of Macros. diff --git a/agr.1 b/agr.1 new file mode 100644 index 0000000..db3e603 --- /dev/null +++ b/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 . +.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. \ No newline at end of file