dist-git conversion

#2781)

AGReader.spec

@@ -1,14 +1,13 @@
 Name:           AGReader
 Version:        1.2
-Release:        2%{?dist}
+Release:        4%{?dist}
 Summary:        Console reader for viewing AmigaGuide files
-
 Group:          Applications/Text
-License:        GPL
+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)
-Provides:       agreader = %{version}-%{release}
 
 %description
 A viewer for the UNIX console which can read and display AmigaGuide files. It
@@ -17,19 +16,19 @@ subset of the v40 specifications.
 
 
 %prep
-%setup -q -n %{name}
+%setup -qn %{name}
 
 
 %build
-cd Sources
+make -C Sources %{?_smp_mflags} CFLAGS="$RPM_OPT_FLAGS"
-make %{?_smp_mflags} CFLAGS="$RPM_OPT_FLAGS"
 
 
 %install
 rm -rf %{buildroot}
-cd Sources
 mkdir -p %{buildroot}%{_bindir}
-install -m0755 agr %{buildroot}%{_bindir}
+mkdir -p %{buildroot}%{_mandir}/man1
+install -m0644 %{SOURCE1} %{buildroot}%{_mandir}/man1
+install -m0755 Sources/agr %{buildroot}%{_bindir}
 
 
 %clean
@@ -39,25 +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
-* Mon Aug 28 2006 Ian Chapman <packages@amiga-hardware.com> 1.2-2%{?dist}
+* 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
 - Release bump for FC6 mass rebuild
 
-* Mon Jun 05 2006 Ian Chapman <packages@amiga-hardware.com> 1.2-1%{?dist}
+* 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
@@ -65,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.

Makefile

@@ -1,21 +0,0 @@
-# Makefile for source rpm: AGReader
-# $Id$
-NAME := AGReader
-SPECFILE = $(firstword $(wildcard *.spec))
-
-define find-makefile-common
-for d in common ../common ../../common ; do if [ -f $$d/Makefile.common ] ; then if [ -f $$d/CVS/Root -a -w $$/Makefile.common ] ; then cd $$d ; cvs -Q update ; fi ; echo "$$d/Makefile.common" ; break ; fi ; done
-endef
-
-MAKEFILE_COMMON := $(shell $(find-makefile-common))
-
-ifeq ($(MAKEFILE_COMMON),)
-# attept a checkout
-define checkout-makefile-common
-test -f CVS/Root && { cvs -Q -d $$(cat CVS/Root) checkout common && echo "common/Makefile.common" ; } || { echo "ERROR: I can't figure out how to checkout the 'common' module." ; exit -1 ; } >&2
-endef
-
-MAKEFILE_COMMON := $(shell $(checkout-makefile-common))
-endif
-
-include $(MAKEFILE_COMMON)

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.