* src/devices/xditview/TODO: Add some more items.

* Makefile.comm (.man.n): Add @APPRESDIR@.
Sort entries.

* src/devices/xditview/gxditview.man: Document GXditview resource
file.
Other documentation enhancements based on a patch from Jörg.


* src/devices/xditview/GXditview.ad: Make all keys work regardless
of the current mouse position.

3 files changed, 53 insertions, 23 deletions

diff --git a/src/devices/xditview/GXditview.ad b/src/devices/xditview/GXditview.ad
index e99ff5e1..bf7ad933 100644
--- a/src/devices/xditview/GXditview.ad
+++ b/src/devices/xditview/GXditview.ad
@@ -9,8 +9,7 @@ GXditview.paned.viewport.height:	800
 GXditview.paned.viewport.showGrip:	false
 GXditview.paned.label.skipAdjust:	true
 
-GXditview.paned.viewport.dvi.translations: #augment \
-	<Btn1Down>:	XawPositionSimpleMenu(menu) MenuPopup(menu)\n\
+GXditview.paned.translations: #augment \
 	<Key>Next:	NextPage()\n\
 	<Key>n:		NextPage()\n\
 	<Key>space:	NextPage()\n\
@@ -23,20 +22,10 @@ GXditview.paned.viewport.dvi.translations: #augment \
 	<Key>Find:	OpenFile()\n\
 	<Key>r:		Rerasterize()\n\
 	<Key>q:		Quit()
+GXditview.paned.viewport.dvi.translations: #augment \
+	<Btn1Down>:	XawPositionSimpleMenu(menu) MenuPopup(menu)
 GXditview.paned.label.translations: #augment \
-	<Btn1Down>:	XawPositionSimpleMenu(menu) MenuPopup(menu)\n\
-	<Key>Next:	NextPage()\n\
-	<Key>n:		NextPage()\n\
-	<Key>space:	NextPage()\n\
-	<Key>Return:	NextPage()\n\
-	<Key>Prior:	PreviousPage()\n\
-	<Key>p:		PreviousPage()\n\
-	<Key>BackSpace:	PreviousPage()\n\
-	<Key>Delete:	PreviousPage()\n\
-	<Key>Select:	SelectPage()\n\
-	<Key>Find:	OpenFile()\n\
-	<Key>r:		Rerasterize()\n\
-	<Key>q:		Quit()
+	<Btn1Down>:	XawPositionSimpleMenu(menu) MenuPopup(menu)
 GXditview.menu.nextPage.label:		Next Page
 GXditview.menu.previousPage.label:	Previous Page
 GXditview.menu.selectPage.label:	Select Page
diff --git a/src/devices/xditview/TODO b/src/devices/xditview/TODO
index 161a7cf1..54cdfc8a 100644
--- a/src/devices/xditview/TODO
+++ b/src/devices/xditview/TODO
@@ -1,4 +1,10 @@
-Replace Imakefile with a configure script.
+Make the arrow keys do the obvious (perhaps behaving similar to gv).
+
+Open the main window with the correct width and height, depending on
+both the selected device and the paper dimensions.
+
+Add a command line option to specify the paper dimensions (similar to
+other groff devices).
 
 Better error handling.
 
diff --git a/src/devices/xditview/gxditview.man b/src/devices/xditview/gxditview.man
index e7598f36..97fa96ec 100644
--- a/src/devices/xditview/gxditview.man
+++ b/src/devices/xditview/gxditview.man
@@ -51,11 +51,11 @@ The
 is different for all devices.
 .
 .B \%gxditview
-can view it for all devices, but the quality is not always good.
+can view it for all devices, but the quality is device dependent.
 .
 .
 .PP
-The best result is achieved with the
+The best results are achieved with the
 .BR X *
 devices for
 .BR groff 's
@@ -82,20 +82,39 @@ for this device and calls
 .B \%gxditview
 automatically for viewing.
 .
+For example, to view this man page with a base resolution of 12pt, say
+.
+.IP
+.B groff \-TX100\-12 \-man \-rS12 gxditview.@MAN1EXT@
+.
+.PP
+(option
+.BI \-rS XX
+is documented in the
+.BR groff_man (@MAN7EXT@)
+man page).
 .
 .PP
 .BR groff 's
 option
 .B \-X
-should be considered obsolete today; it produces
+produces
 .I intermediate output
-for
+for the
 .I Postscript
-and uses
+device and subsequently uses
 .B \%gxditview
-as a viewer for it, but with a bad quality.
+as a viewer for it.
+.
+The quality of the result depends mainly on the chosen point size and
+display resolution; for rapid previewing, however, something like
+.
+.IP
+.BI "groff \-X \-P\-resolution \-P100 " document
+.
+.PP
+yields acceptable results.
 .
-Simply don't use it.
 .
 .
 .PP
@@ -380,6 +399,22 @@ and
 for more details.
 .
 .
+.SH FILES
+.TP
+.B @APPRESDIR@/GXditview
+The default resource file of
+.BR \%gxditview .
+Users should override these values in the
+.B .Xdefaults
+file, normally located in the user's home directory.
+.
+See
+.BR xrdb (1)
+and
+.BR appres (1)
+for more.
+.
+.
 .SH "SEE ALSO"
 .BR X (1),
 .BR xrdb (1),