1 files changed, 0 insertions, 162 deletions
diff --git a/noncore/apps/opie-reader/README b/noncore/apps/opie-reader/README
deleted file mode 100644
index d091010..0000000
--- a/noncore/apps/opie-reader/README
+++ b/dev/null
@@ -1,162 +0,0 @@
-What is QT Reader?
-==================
-QT Reader is an e-text reading program which understands several
-varieties of PalmDoc format (types 1,2 and 4), zTxt, plain text and
-gzipped text.
-In addition it supports its own very highly compressed format which is
-based on ppm (regarded by many as the best available compression
-technique) with modifications by Fabrice Bellard for speed and memory
-efficiency and by myself to support random access on smaller
-devices. I call this modified format ppms (for ppm, segmented).
-The ppms program which is used to produce ppms files from plain text
-is available from http://www.timwentford.uklinux.net where there is
-also a comparison of file sizes produced by several compression
-methods. This is summarised below:
-Compression method        Size in bytes   Memory required to decompress
-Plain text                573714          N/A
-Makedoc (PalmDoc format)  329543          2k
-ppms (default)            184187          350k
-ppms (best)               151733          800k
-bzip2 -1                  180175          340k
-bzip2 -9                  154280          2.2M
-The default settings used here were chosen to suit the Agenda VR3. I
-would expect the Zaurus to be able to use settings which give 170kb
-file size and 500k memory without any problem. The format encodes the
-settings used so the user may choose whatever suits them. I choose
-based on the amount of memory required and on whether or not pageup
-performance is acceptable.
-General Use
-===========
-Start it up and then choose "File/Open" from the menu. Select a
-palmdoc, plain text, gzipped text or ppms file from the file selector
-and use the cursor keys to page up/down (up/down keys) and to make the
-text size comfortable (left/right keys) and thats it for most
-uses. See below for more advanced use.
-What the Menu Options Do
-========================
-File
-====
-File operations live in this menu.
-Open         Brings up the file selector to allow you to choose a
-             new file to read.
-Info         Displays info about the currently open file. Needs
-             reformatting.
-Start Block  Marks the text at the top of the currently displayed
-             page ready for copying.
-Copy Block   Copies all text from the mark to the bottom of the
-             currently displayed page to the clipboard.
-Scroll       Starts/stops autoscroll. The speed can be adjusted
-             using the up/down keys while autoscroll is on (page
-             up and down are still functional and can be activated
-             by using the up and down arrows on the task bar).
-Jump         Jumps to a specific offset in the file. If you note
-             down the current location from the File/Info display
-             you can then jump to the same position again using
-             this function (or you could bokmark it 8^)).
-Page/Line scroll When this is On pressing the arrows (keys or
-             icons on the task bar) moves you a page at a time.
-             When this is off, pressing the arrows moves you a
-             line at a time.
-Set Overlap  Sets the number of lines of overlap between pages
-             when scrolling by page.
-Set Dictionary When you tap on the screen the word under the
-             pointer is copied to the clipboard ready for pasting
-             into (e.g.) a dictionary program. Using this function
-             allows the word to be sent to compatible dictionary
-             programs direct. The format is exename/messagename
-             where exename is the name of the executable for the
-             dictionary program and messagename is the name of the
-             message it is expecting. You can get some idea of how
-             it works by using some debug functionality which I
-             deliberately left in QTReader. Set this to
-             uqtreader/info.
-             To deactivate it again, set it to /.
-Find         Brings up the search requester where you can enter a
-             regular expression to search (again) for.
-Format
-======
-Used to alter the way the text is reformatted before display.
-Strip CR     Removes those pesky DOS crs from the file.
-Strip HTML   Uses a very simple minded filter to remove html mark-up.
-Dehyphen     Removes hyphens from e-texts which have been formatted to
-             fit on different sized displays by hyphenating words
-             which no longer appear at the end of the line.
-Unindent     Removes leading spaces from the beginning of paragraphs.
-Re-paragraph Removes/adds line breaks as necessary to make the text
-             look nice on the display.
-Double Space Adds an extra space between paragraphs.
-Indent+      Increases the number of extra leading spaces inserted
-             before paragraphs.
-Indent-      Decreases the number of extra leading spaces inserted
-             before paragraphs.
-        Bold     Sets the font to bold (if its supported by the currently
-             selected font).
-For e-texts from fictionwise I don't need any of these enabled. For
-Project Gutenberg e-texts I enable Strip CR, Re-paragraph and either 3 lots
-of indent+ and/or double space.
-Zoom         Menu option not implemented but pops up an info box
-             telling you that left/right cursor keys will zoom
-             out/in.
-Ideogram/Char grouping When selected, treats each character as a word
-             and enforces uniform character spacing - suitable for
-             many eastern character sets. When not selected, looks for
-             spaces in the text to identify words - suitable for most
-             western texts. (I'm not a language expert so forgive my,
-             probably inaccurate, generalisations).
-Set Width    Sets the character spacing as a percentage of the text
-             height to be used when in ideogram mode. Start at 100 and
-             experiment to find what you like best.
-Encoding     Allows you to choose from a variety of codings. Ascii is
-             actually unprocessed text so its precise behaviour may
-             depend on the machines locale setting. Palm and code page
-             1252 are very similar and are useful if you have an etext
-             aimed at Palms or Windows machines which use an extended
-             character set - though you will need to use a unicode
-             enabled font to show all the characters. The U... fonts
-             are different varieties of unicode encodings. If you
-             don't know what that means you probably don't need them
-             (they allow texts to access the full range of characters
-             required for non US English languages).
-Set Font     Allows you to choose which font the text is displayed
-             in. Helvetica or smoothtimes are probably best for ascii type
-             texts, unifont or cyberbit (if you have installed them)
-             are best for extended character sets (other unicode fonts
-             may also be available but these are all I've found, so far).
-Marks
-=====
-        Mark     Saves the current position as a bookmark
-Goto         Allows selection of a bookmark to jump to.
-Delete       Deletes an unwanted bookmark from the current text.
-Autogen      Displays a box for entering a regular
-             expression which will be used to determine which
-             paragraphs (not lines) will be marked to allow jumping to
-             directly using the Goto option. The format options
-             described above are applied before the regular expression
-             matching is done.
-             This operation is performed in the background allowing
-             you to continue paging up/down the e-text.
-Clear        Deletes all in-memory bookmarks from the current document.
-Save         Saves the "in-memory" bookmarks to disk.
-Tidy         Deletes bookmark file for a document. The operations
-             above work on an in-memory copy of the bookmarks. This
-             option makes that copy more permanent (you will also be
-             prompted to save the bookmarks when closing a text if the
-             in-memory copy is different to the saved copy).

diff --git a/noncore/apps/opie-reader/README b/noncore/apps/opie-reader/README deleted file mode 100644 index d091010..0000000 --- a/noncore/apps/opie-reader/README +++ b/dev/null
@@ -1,162 +0,0 @@
1	What is QT Reader?
2	==================
3
4	QT Reader is an e-text reading program which understands several
5	varieties of PalmDoc format (types 1,2 and 4), zTxt, plain text and
6	gzipped text.
7
8	In addition it supports its own very highly compressed format which is
9	based on ppm (regarded by many as the best available compression
10	technique) with modifications by Fabrice Bellard for speed and memory
11	efficiency and by myself to support random access on smaller
12	devices. I call this modified format ppms (for ppm, segmented).
13
14	The ppms program which is used to produce ppms files from plain text
15	is available from http://www.timwentford.uklinux.net where there is
16	also a comparison of file sizes produced by several compression
17	methods. This is summarised below:
18
19	Compression method Size in bytes Memory required to decompress
20	Plain text 573714 N/A
21	Makedoc (PalmDoc format) 329543 2k
22	ppms (default) 184187 350k
23	ppms (best) 151733 800k
24	bzip2 -1 180175 340k
25	bzip2 -9 154280 2.2M
26
27	The default settings used here were chosen to suit the Agenda VR3. I
28	would expect the Zaurus to be able to use settings which give 170kb
29	file size and 500k memory without any problem. The format encodes the
30	settings used so the user may choose whatever suits them. I choose
31	based on the amount of memory required and on whether or not pageup
32	performance is acceptable.
33
34	General Use
35	===========
36
37	Start it up and then choose "File/Open" from the menu. Select a
38	palmdoc, plain text, gzipped text or ppms file from the file selector
39	and use the cursor keys to page up/down (up/down keys) and to make the
40	text size comfortable (left/right keys) and thats it for most
41	uses. See below for more advanced use.
42
43	What the Menu Options Do
44	========================
45
46	File
47	====
48
49	File operations live in this menu.
50
51	Open Brings up the file selector to allow you to choose a
52	new file to read.
53	Info Displays info about the currently open file. Needs
54	reformatting.
55	Start Block Marks the text at the top of the currently displayed
56	page ready for copying.
57	Copy Block Copies all text from the mark to the bottom of the
58	currently displayed page to the clipboard.
59	Scroll Starts/stops autoscroll. The speed can be adjusted
60	using the up/down keys while autoscroll is on (page
61	up and down are still functional and can be activated
62	by using the up and down arrows on the task bar).
63	Jump Jumps to a specific offset in the file. If you note
64	down the current location from the File/Info display
65	you can then jump to the same position again using
66	this function (or you could bokmark it 8^)).
67	Page/Line scroll When this is On pressing the arrows (keys or
68	icons on the task bar) moves you a page at a time.
69	When this is off, pressing the arrows moves you a
70	line at a time.
71	Set Overlap Sets the number of lines of overlap between pages
72	when scrolling by page.
73	Set Dictionary When you tap on the screen the word under the
74	pointer is copied to the clipboard ready for pasting
75	into (e.g.) a dictionary program. Using this function
76	allows the word to be sent to compatible dictionary
77	programs direct. The format is exename/messagename
78	where exename is the name of the executable for the
79	dictionary program and messagename is the name of the
80	message it is expecting. You can get some idea of how
81	it works by using some debug functionality which I
82	deliberately left in QTReader. Set this to
83	uqtreader/info.
84	To deactivate it again, set it to /.
85	Find Brings up the search requester where you can enter a
86	regular expression to search (again) for.
87
88	Format
89	======
90
91	Used to alter the way the text is reformatted before display.
92
93	Strip CR Removes those pesky DOS crs from the file.
94	Strip HTML Uses a very simple minded filter to remove html mark-up.
95	Dehyphen Removes hyphens from e-texts which have been formatted to
96	fit on different sized displays by hyphenating words
97	which no longer appear at the end of the line.
98	Unindent Removes leading spaces from the beginning of paragraphs.
99	Re-paragraph Removes/adds line breaks as necessary to make the text
100	look nice on the display.
101	Double Space Adds an extra space between paragraphs.
102	Indent+ Increases the number of extra leading spaces inserted
103	before paragraphs.
104	Indent- Decreases the number of extra leading spaces inserted
105	before paragraphs.
106	Bold Sets the font to bold (if its supported by the currently
107	selected font).
108
109	For e-texts from fictionwise I don't need any of these enabled. For
110	Project Gutenberg e-texts I enable Strip CR, Re-paragraph and either 3 lots
111	of indent+ and/or double space.
112
113	Zoom Menu option not implemented but pops up an info box
114	telling you that left/right cursor keys will zoom
115	out/in.
116	Ideogram/Char grouping When selected, treats each character as a word
117	and enforces uniform character spacing - suitable for
118	many eastern character sets. When not selected, looks for
119	spaces in the text to identify words - suitable for most
120	western texts. (I'm not a language expert so forgive my,
121	probably inaccurate, generalisations).
122	Set Width Sets the character spacing as a percentage of the text
123	height to be used when in ideogram mode. Start at 100 and
124	experiment to find what you like best.
125	Encoding Allows you to choose from a variety of codings. Ascii is
126	actually unprocessed text so its precise behaviour may
127	depend on the machines locale setting. Palm and code page
128	1252 are very similar and are useful if you have an etext
129	aimed at Palms or Windows machines which use an extended
130	character set - though you will need to use a unicode
131	enabled font to show all the characters. The U... fonts
132	are different varieties of unicode encodings. If you
133	don't know what that means you probably don't need them
134	(they allow texts to access the full range of characters
135	required for non US English languages).
136	Set Font Allows you to choose which font the text is displayed
137	in. Helvetica or smoothtimes are probably best for ascii type
138	texts, unifont or cyberbit (if you have installed them)
139	are best for extended character sets (other unicode fonts
140	may also be available but these are all I've found, so far).
141	Marks
142	=====
143
144	Mark Saves the current position as a bookmark
145	Goto Allows selection of a bookmark to jump to.
146	Delete Deletes an unwanted bookmark from the current text.
147	Autogen Displays a box for entering a regular
148	expression which will be used to determine which
149	paragraphs (not lines) will be marked to allow jumping to
150	directly using the Goto option. The format options
151	described above are applied before the regular expression
152	matching is done.
153	This operation is performed in the background allowing
154	you to continue paging up/down the e-text.
155	Clear Deletes all in-memory bookmarks from the current document.
156	Save Saves the "in-memory" bookmarks to disk.
157	Tidy Deletes bookmark file for a document. The operations
158	above work on an in-memory copy of the bookmarks. This
159	option makes that copy more permanent (you will also be
160	prompted to save the bookmarks when closing a text if the
161	in-memory copy is different to the saved copy).
162