tejpWriter v3.40 b9
Users Manual


Updated 28/10/2006

Contents

  1. Introduction
  2. Features
  3. Getting Started
  4. The Editor
  5. The Viewer
  6. The tejpWriter Format
  7. The Toolbar Skin
  8. Font Support
  9. The File Limit
  10. Known Problems
  11. About This Document


1 Introduction

This Users Manual was written to help you to become familiar with, and to get the most out of tejpWriter. It contains a lot of important information that you can't do without, because although tW is designed to be logical and intuitive, some of its most powerful secrets are not revealed by themselves. So take your time and read the Getting Started chapter. You will not regret it.

For the one who wants to learn the tW Format, this manual may serve as an example—it is all written in tejpWriter Format on a Palm Tungsten|T5 using tejpWriter 3.30.

I sincerly hope you enjoy using tejpWriter as much as I enjoyed making it.

2 Features

From version 3.00, tejpWriter is no longer just an editor, but also a viewer of tejpWriter Formatted text—tWF. tWF is a truly simple but powerful way of blowing life into your text files and Palm docs.
The editor and the viewer are tightly matched making it possible to switch between them at any time, at any position. The main user interface is common for both, except for the toolbar buttons below the Scrollbar.


3 Getting Started


  1. Switching between Editor and Viewer
  2. Toolbar basics
  3. Palm docs vs text files
  4. Loading and opening documents
  5. Closing, Saving, and Unloading documents
  6. Navigating the text
  7. Choosing Clipboard
  8. Selecting text
  9. Using the Quick Edit Functions
  10. Changing color and font on the main field
  11. Manipulating the components of the user interface
  12. Synchronizing text position when switching between Editor and Viewer
  13. Importing MS Word documents
  14. Importing other documents
  15. Switching between two document
  16. Looking up words in dictionaries
  17. Exporting to HTML format
  18. Creating internal links
  19. Importing from, and exporting to Memo
  20. Encrypting text files


Getting Started
Switching between Editor and Viewer

  1. Drag up on the MiniDisplay
  2. Press and hold on the MiniDisplay, then tap on Switch Mode.
  3. Tap on Menu/+/Editor or Viewer.
  4. Double-press the 5way Navigator Center button

Getting Started
Toolbar basics
The Toolbar is designed to give the user maximum control over the text with a minimum of work using a stylus.
When using an external keyboard the Toolbar can be hidden by dragging down on the MiniDisplay. To get the Toolbar back, just tap and hold on the screen.

In Editor mode, all Toolbar buttons, except the Scrollbar and the Scroll buttons to the right, can contain up to 5 Fast Functions and many more Secondary Functions, all related in some way or another to make it easy to remember where to find them. The Fast Function most used, is reached by a simple tap on the button. The other four Fast functions are reached by placing the stylus on the button and dragging it up, down, left, or right until the stylus is outside the button where it is lifted from the surface. The Secondary Functions are reached by tapping and holding until the Secondary Function-list pops-up. This list serves two purposes. The first is to help indicating what Fast Functions are tied to that button. Therefore the Secondary Function-list always starts with the Fast Functions prefixed with symbols: • simple tap, ^ drag up, v drag down, < drag left, and > drag right. In the beginning it is a good idea to tap and hold on the buttons until the Fast Functions are memorized.
The second purpose of the Secondary Function-list is to host the rest the functions related to that button. These can be found below the Fast Functions.
In Viewer mode only the Document button and the Favorite button contain multiple functions, all other buttons only have one function.

Toolbar Buttons


  • Document
    Loading of text files to documents from memory card, opening of documents, document filtering. Also indicates shift and caps lock.
  • Save
    Saving to memory card
  • MiniDisplay
    Positioning, and editing information. Also contains user interface functions.
  • The Scrollbar
    Fast positioning including going to the beginning and the end of the document.
  • Scroll buttons
    Line and page positioning
  • Visual
    Font and color
  • Bookmark
    Bookmarks
  • Find & Replace
    Finding and replacing text

(Editor Buttons)
  • Mark
    Fixed position marks used for word count, jumping, and selection.
  • Copy
    Copying and cutting of text to the clipboard.
  • Paste
    Pasting of text from the clipboard and insertion of em dash and ellipsis.
    If the XClipboard is used also insertion of phrases.
  • Undo
    Undo of the last text operation.
    If the XClipboard is used the undo capacity is 32 text operations. Pasting of trash back into the text.
  • Case
    Fast change of the case of selected text.
  • Embrace
    Fast insert of embracing characters, like parenthesis and quotes, around selected text.
  • tWF
    tW Formatting of text.
  • Word Lookup
    Fast Word Lookup in external dictionaries.
(Viewer Buttons)
  • TOC
    Takes you to the Table Of Contents. Is only enabled if a TOC anchor is found in the doc. The TOC anchor has the ID: 999.
  • Back
    Goes to the position before the last link tap or bookmark jump.
  • Forward
    If you tapped back you Forward takes you to the position before the Back tap.


Getting Started
Palm docs vs text files
Palm originally only had what is called RAM, or Random Access Memory. RAM is the memory which the processor work with. It is fast, and even faster thanks to the database structure with which files are stored in RAM. Yes, even text files are stored as databases. The Palm doc format uses standard Palm RAM databases which has a header record as record zero. This header stores, among other things, the text size and the number of data records the database has. The rest of the records contain the text. The records are of variable length, but the maximum size is 4096 characters. To insert one word into the middle of a Palm doc, a new record with the size of the word is inserted and after that, the header is updated. This is as you can understand an extremely fast way of updating a text in comparison to insert a word into a sequential file like a text file, where the whole file first needs to be copied into the RAM where it is updated, and then re-written to the media (memory card or harddisk drive) where it is stored. Palm docs can be copied to the memory card as sequential files, but they need to be copied back to RAM to be updated or read. Palm docs can only be read by the a Palm. Having said that, there exist software able to read Palm docs on other operating systems.
Getting Started
Loading and Opening documents

To Load a text file is to copy it from its media (memory card) into RAM, transforming it into a Palm doc database.
Drag right on the Toolbar Document button or choose Menu/Doc/Load. Select the file you want to Load and press OK. First the doc will be Loaded, then automatically Opened.

To Open a doc is to make a Palm doc database in RAM readable in the Viewer or editable in the Editor.
Drag up on the Toolbar Document button or choose Menu/Doc/Filter to select which type of text file you want to open. If you don't know which to choose, choose All.
If you already have chosen a filter, just tap on the Toolbar Document button or choose Menu/Doc/Open.
Select the doc you want to open from the popup list by tapping on it.
Getting Started
Closing, Saving, and Unloading documents

To Close a doc is to disconnect it from application so that it no longer is readable in the Viewer or editable in the Editor. As this is being done, the field is written back into the database and the header updated.
Close the doc by choosing Menu/Doc/Close. You normally don't need to close a doc. It will automatically close when Opening another doc or when starting another application.

To Save a doc is to transfer the Palm doc database into a sequential text file which is written onto its media (memory card).
Tap on the Toolbar Memory Card button os choose Menu/Doc/Save. If there is no need to specify where to save the doc or what format to save it in, it will be saved without asking anything, otherwise the Save as form will come up. Specify format, save path, and if you want to Unload the doc from RAM, then press OK.
If you want to save the doc under another name or in another place than before, then drag right on the Toolbar Document button (Editor only) or choose Menu/Doc/Save as.

To Unload a doc is to remove the Palm doc database from the RAM when it's no longer needed.
Warning! Before Unloading a doc, make sure it's saved on a memory card. There is no way of getting it back.
Unload the doc by choosing Menu/Doc/Unload. You can also Unload a doc when Saving as by setting the Unload button.
Getting Started
Navigating the text
The Scrollbar (Editor and Viewer)
The Scrollbar is the fastest way to go from one place in the text to another although it also is the most inaccurate one. Its leftmost position corresponds to the Beginning Of Text, BOT, and the rightmost position to the End Of Text, EOT. To go to the BOT, place the stylus somewhere at the left end of the Scrollbar, drag left until the stylus is outside the scrollbar area, then lift the stylus. This will place the cursor at position 0. To go to the EOT, place the stylus somewhere at the right end of the Scrollbar, drag right until the stylus is outside the scrollbar area, then lift the stylus.
To go to an approximate place in the text, just tap on the point on the scrollbar which corresponds to the text position, Ex: to go to the middle of the text, tap on the middle of the scrollbar. It is also possible to drag or move the scrollbar handle to the wanted position, but it's not necessary—it's much faster to just tap.

Toolbar Scroll buttons (Editor and Viewer)
Fine adjust the text position by using the Toolbar Scroll buttons or the 5way navigator up/down buttons. The Toolbar Scroll buttons consists of one pair for Line up/down and one for Page up/down. In the middle of the Line up/down and the Page up/down buttons are two indicators showing what mode the 5way Navigators up/down buttons are in. If the indicator is on between the Line up/down buttons, it's in line up/down mode. If the one between the Page up/down buttons is on, it's in page up/down mode. To switch mode press the 5way Navigator Center button once.

Menu/Edit/Go to (Editor and Viewer)
Menu/Edit/Go to makes it possible to go to a exact character position in the text. Frankly, I have never used it myself except when testing the function. Who knows the exact position he wants to go to?

Find & Replace (Editor)
A very useful tool is Find & Replace. If you found one word in the text and you want to find the other places where this word was used, select the word or phrase. You can even include a linefeed. The maximum length to search for is 31 characters. With the selection made, open the Find & Replace form. The find field will already contain the word or phrase you want to search for, so it's just to tap on the Find button. The search will continue from that point in the text until it reaches the EOT. During the search, the Find & Replace form stays open. If a match is found, it will be highlighted on the second row from the top. This to make it easier to understand in what context the found word or phrase is used. If no match is found the Find & Replace form will close. To start the search from the beginning of the text, BOT, select the Top button. To make the search case sensitive, select the Case button. To search for a word that also can be part of other words, it's a good idea to select the Word button.
Replace a found of selected word with the contents of the Replace field, tap on Replace button. After the replace is done, a new find is performed automatically. To suppress this automatic find, select the M button. M stands for manual find.
All replaces all matches in the whole text and places the cursor at the EOT.
A search can be Canceled by pressing the Cancel button. Replace All can not be canceled.

Find (Viewer)
Find works the same way as the above described Find & Replace with the differences that no replace is available and that the matches are shown on the first line without highlighting.

Quick Find (Editor)
Quick Find is what the name says. Select a word (if Smart Word Select is set, no need to select the word, just put the cursor on it) or phrase and drag up on the Toolbar Find button. Quick Find will now search from the present position until EOT. If a match is found, the word will be highlighted. To make a new Quick Find, drag up on the Toolbar Find button again.
Quick Find is dependent on the Case and Word options set in the Find & Replace form.

The Bookmark tool (Editor)
The Bookmark tool is not only powerful, but also simple and really easy to use.
To place a bookmark, place the cursor on, right before, or right after the word which you want to mark, then drag up on the Toolbar Bookmark button. The bookmark character will be inserted immediately before the chosen word.
To view the bookmarks, tap on the Toolbar Bookmark button and a list of all the bookmarks in the text pops up. This list is always updated. New bookmarks will therefore show up at once. To jump to a bookmark just tap on it on the list.
Remember that bookmarks are flexible. No matter how many changes is made to the text, the bookmark will always be found at the right place.
To remove a bookmark, select it on the bookmark list. The cursor will be placed immediately to the right of the bookmark character. Make a backspace and the bookmark is gone.

Bookmarks (Viewer)
In the Viewer the bookmark characters are invisible. You can neither insert bookmarks nor remove them—only use them. They are a great complement to the links. To pop-up the bookmark list, Tap in the Toolbar Bookmark button or press the 5way Navigator Right button.
Getting Started
Choosing Clipboard
tW comes with two different types of clipboards—the Default Clipboard and the XClipboard. Why two clipboards? To get the answer to that, look at their differences.
The Default Clipboard
Of conventional type stored in memory invisible to the user.

+ Fast
+ Takes up no extra RAM space

- Limited to 32kb
- Stores only one clipboard-item
- Standard Palm OS undo: 1 operation, 1 kb

The XClipboard
All clipboard-item are stored as Palm docs with the file extension .clp, visible and editable by the user. All deleted items are also stored as Palm docs but with the file extension .tra. They are used for the Undo function.

+ Only limited by the amount of free RAM
+ Undo: 32 operations, no limit.
+ Trash list containing all deleted items ready to be pasted back into the text if needed
+ Clip list with the latest clipboard-items. Can store up to 99 clipboard-items if the amount of available RAM permits it.
+ Phrase list
+ Flexible. Easy to convert a clipboard item to a normal doc and the other way around

- Slow when copying and pasting small chunks of text.
- May take up a lot of extra RAM space


Comparing this with your needs, it should be easy to determine which clipboard to use.
Ex 1: If you have little available RAM, the best choice is to use the default clipboard.
Ex 2: If you have enough RAM, write a lot, and need a powerful undo, you might want to use the XClipboard.

Both clipboards are fully adapted to the Palm OS clipboard. Copy to the Palm OS clipboard and paste into tW or the other way around as long as the text copied isn't bigger than 1 kb. It even works with DA's.
To Avoid Confusion
If Menu/Setup/Editor/XClipboard is checked the Default Clipboard is inactive. XClipboard then uses all Standard Select, XSelect, and Smart Word Select.
In the case Menu/Setup/Editor/XClipboard is not checked, the XClipboard is inactive. The Default Clipboard then uses Standard Select, and Smart Word Select.
Only one of the clipboards is active at the time.

Getting Started
Selecting text
Standard Select
Standard Select is the normal way selection works in Palm OS. Drag over the text to select and it gets highlighted. You can also select a word by double tapping on it. Triple tapping selects a whole line including existing linefeeds. Triple tapping and holding down, then dragging, selects multiple lines. The limit for selecting text in Palm OS is 64 kb. In tW it is, however, limited to 32kb. This has to do with the swapping technique used to make it possible to edit files larger than 64kb.

XSelect
XSelect takes off when Standard Select doesn't reach longer. That means it has to go beyond the limitations of Palm OS. In order to do that it also has to operate in a non-standard way. This is how it works:
  1. Place the cursor on the position where the selection should start.
  2. Tap the Mark button. To indicate that the start of selection is set (the Selection Mark), the icon turns into a red dot like a recording symbol.
  3. Move the cursor to the position where the selection should end. It can be either before or after the Selection Mark. The selection is now made.
    Be careful! You don't see the normal highlight, only the recording symbol. It's easy to by mistake delete the selection. If this happens, you have the XUndo to save you.


If you have the Selection Mark on and at the same time make a Standard Selection with highlight, the Standard Selection has priority over the XSelection.
After any operation with a XSelected text, the Selection Markis turned off.
To turn off the Selection Mark without any operation, tap a second time on the Mark button.
XSelect has no limitations. It is possible to select documents as big as the Bible if necessary. It has another advantage. It may sometimes be quicker than Standard Select since you don't have to scroll over large part of the text dragging the stylus. Just set the Selection Mark, then use any navigation tool to get to the place where the selection should end. Place the cursor and execute the operation.
If you want to check that the XSelection is right, it's possible to jump between the Selection Mark and the cursor position and back again by doing v on the Mark button.
*The XSelect function is only available when using the XClipboard. If the Default Clipboard is used, the Selection Mark can be used as a normal jump mark.


Smart Word Select
This is a real time saver. If you want to copy a word or use one of the quick editing functions, Smart Word Select is what you need.
How to Copy a word:
  1. Place the cursor just before the word, inside it, or right after it leaving no spaces between the cursor and the word.
  2. Tap on the Copy button.


*Smart Word Select works with several functions: Quick Find, Copy, Cut, Case, Embrace, insert Bookmark, and some of the tWF functions, both with the normal clipboard and the XClipboard.

Getting Started
Using the Quick Edit Functions
With the Quick Edit Functions, I have tried to release the strength of the Palm and its stylus. Small but frequent editing operations are made by the computer instead of user, making editing faster and easier. The base for for it all is Smart Word Select. It makes it really easy to change Case, Embrace, mark as Italic or Bold, create Internal Links, or insert a Bookmark. To give you an idea how it works I made a few examples.

Ex 1. You write a name, but when writing it you realize that you forgot to start with a capital letter.
Normally: You would place the cursor after the first letter in the word, make a backspace, and then place the cursor where you stopped writing.
The Quick Edit way: Finish writing the word, then leave the cursor directly after the word without any space between the word and the cursor. Do > on the Case button.
This happens: The word is selected and the Case function changes the first letter in the word to a capital letter. Then the cursor is placed at the end of the word so that you can continue where you were.

Ex 2. You want to Copy a word from the beginning of a sentence and Paste it into the middle of a sentence. Doing so you need to change the first letter from uppercase to lowercase.
Normally: You would double tap on the word then tap on the Copy button. After having pasted it into the sentence, you would place the cursor after the first letter, make a backspace to remove it, and then enter the same letter in lowercase.
The Quick Edit way: Place the cursor in the word without selecting any part of it. Tap on the Copy button and paste it into the sentence. Do v on the Case button.
This happens: When tapping on the Copy button the word is selected and copied. After having pasted it into the sentence the cursor is placed directly to the right of the word. Smart Word Select can therefore select the word so that the Case function can transform all letters into lowercase.

Ex 3. You want to delete the word you just wrote. The cursor is just beside it.
Normally: You would make several backspaces until the word was gone.
The Quick Edit way: Just do ^ on the Copy button.
This happens: The word is selected and then cut.
Getting Started
Changing color and font on the main field
To change the appearance of the text may help the writer to find errors. This can be done in two ways: by changing the font or by changing the colors. Both are done on the "F" button, the second button from the left on the toolbar.
Change font: v, or ° and choose Font
Change color: ^, or ° to choose Color Theme. You can switch between ten different color themes. The color themes may be setup in Menu/Setup/Looks/Theme
The font and color theme are kept until another change is made. A Favorite setting of both font and color theme may be stored: press and hold the "F" button, and choose Set Favorite. To come back to the Favorite setting: press and hold the "F" button, and choose Favorite. To restore the system colors: choose System default on the same menu. The Editor and the Viewer have separate settings including the Favorite setting.
Getting Started
Manipulating the components of the user interface
To make user interface fit different tastes, it's made as flexible as possible. As a result you can turn on and off all of its different components.
On non DIA devices: the Tapboard and the Toolbar.
On DIA devices: the Tapboard, the Thumbboard, the Statusbar, and the Toolbar.

Actions on the "MiniDisplay" button for the components:


The same functions are available on Menu/+/
*When closing the Thumbboard, tW returns to the state it had before turning the Thumbboard on.
*On DIA devices the screen rotation and DIA are controlled on the Statusbar.

Getting Started
Synchronizing text position when switching between Editor and Viewer
Before switching from one mode to another, make sure that the text, you want to find after the switch, is on the first line. Doing this will always place at least a part of that text on the first line after the switch. There is always a certain text gliding when switching. This is due to different fonts and printing area on the screen between the modes, which changes the disposition of the text within paragraphs. Total synchronizing is impossible without changing the true layout of the text.
Getting Started
Importing MS Word documents
Now it's easy to import MS Word documents into Palm doc format. Just Load the MS Word document as if it was an ordinary text file. But remember that you that you will loose all original formattation.
Getting Started
Importing other documents
Sometimes it might be necessary to read other documents than text documents on your Palm. tW gives you that possibility by importing the file "raw". tW will substitute all NULL characters with space characters. Any file type can be imported but not all files make sense importing. Some has used this to import database files to copy information from them. This is how it's done:
  1. Tap on Menu/Doc/Load or drag right on the Toolbar Doc button.
  2. Tap on Manual button and then the LAC button.
  3. Load the desired file.
  4. Ready!

Getting Started
Switching between two document
  1. Open or load the first document.
  2. Open or load the second document while the first document still is open.
  3. Switch between the two documents by dragging down on the Toolbar document button or choosing Menu/Doc/Previous.

Getting Started
Looking up words in dictionaries
tW can launch all kinds of dictionaries in Editor mode: those that has to be launched normally, those that are memory resident and can be launched by tapping an icon on the commandbar, and those that are Desktop Acessories, so called DAs, launched on top of a running program.
But tW does not only launch the dictionaries—it automatically selects the word on which the cursor is placed if no selection already exists, copies it to the Palm OS clipboard, and then runs one of the different launch functions. Most dictionaries then pastes what's in the clipboard into the seach field and locates the definition. For dictionaries that doesn't paste the clipboard automatically into the search field, a manual paste has to be performed.

Launching Dictionaries Normally
Most dictionaries can be launched this way, even those that can be launched by tapping on a Commandbar icon.
  1. Verify that Smart Word Select under Menu/Setup/Editor/Smart W Sel is set.
  2. Write in the database name of the dictionary to be launched in the Menu/Setup/Word Lookup/Drag up field, the Drag right field or in the Drag left field. As you can see, two different dictionaries can be launched this way. Leave out the extension ".prc".
  3. Place the cursor in the searched word and drag right to launch the dictionary entered into the Drag right field. tW will close normally and the dictionary will open up. If you launch Noah Pro, Slovoed, or MSDict, the word can automatically be pasted into the search field.
  4. To return to tW you have to launch tW again. There are different ways of doing it. You can launch it by tapping on the launcher icon as usually, or, if you have a T5 as I have, you can tap an hold on the app icon and the most resently used applications comes up. tw should be one on the top. Or you can configure an application like McPhling, or HiLauncher to launch the previously launched app by tapping on for example a silk button. This is of course the fastest way.


Personally, I feel this is the most robust way since tW is closed normally and the opened document therefore is saved. This is not the case when launching from the Commandbar or launching a DA.

Launching Memory Resident Dictionaries from the Commandbar
  1. Verify that Smart Word Select under Menu/Setup/Editor/Smart W Sel is set.
  2. Make sure the field Menu/Setup/Word Lookup/Drag up, Drag right field or Drag left field is left empty. This indicates that the function is to be used to open the Commandbar.
  3. Place the cursor in the searched word, and do ^, <, or >, depending on the on setup, on the Word Lookup button. This bring up the Commandbar without any clipboard icons, with space for memory resident dictionaries icons.
  4. Tap on one of the icons of the dictionaries you have configured for memory resident launch from the Commandbar.
  5. The dictionary launches on top of tW and pastes the clipboard contents into the search field, if it is configured to do that. The word should be found automatically.
  6. To return to tW, just close the dictionary.


I recommend saving the doc often as a precaution, not to loose any information if the dictionary should crash.

Launching DA Dictionaries
The procedure is the same as for Launching Dictionaries Normally, exept for step 4. To return to tW, just close the DAs window.

Just as for Launching Memory Resident Dictionaries from the Commandbar, I recommend saving the doc often as a precaution, not to loose any information if the dictionary should crash.
Getting Started
Exporting to HTML format
tW can export tW Formatted documents to HTML v4.01 documents and still maintain the visual of the original document. This feature makes it possible to have a document like this manual, written with tejpWriter, exported to an HTML document, and shown on the web without further editing needed. This is a truly powerful tool, which, although limited to the tW Format, makes it possible to create simple web pages on the Palm. The HTML Export function, however, is not meant to make tW into a fully fledged HTML editor, but rather to make it possible to transfer documents written with tW to HTML format and display them on the web, with as little distortion as possible, when ever an update of the original document has taken place.

This is how it works:
  1. Go to Menu/Setup/HTML Setup to setup the export.
  2. Open the document you want to export.
  3. Switch to the Viewer to decide which Color Theme to use. The exported HTML document inherits all colors from the document displayed in the Viewer.
  4. Switch back to the Editor and choose Menu/Tools/HTML Export. The original document will be closed and a new HTML document created and opened. The HTML document automatically gets the original document name transferrered to lowercase, spaces changed to underline characters, and the file extension changed to .html.
  5. To make an ordinary text documnet out of it, use Save as to save the document to the memory card.

Getting Started
Creating internal links
Creating a new internal link is basically simple but may still be a bit awkward. The process can be summarized in six steps:
  1. Marking the a phrase as an anchor (or link).
  2. Finding an ID number which is not already used.
  3. Pasting in the ID number of the anchor (or link).
  4. Moving to the place for the matching link (or anchor) while trying to remember the ID number.
  5. Pasting in the ID number of the matching link (or anchor).
  6. Testing the link.


This can of course be done manually, but luckily tW and the provides a few tools which can very helpful. Here is how it's done:
  1. Select the phrase to become a link. If it's a word, no need to do that as long as Smart Word Select is set.
    < on the tWF button. The link is now marked and the cursor the position for next step.
  2. No need to find an ID. tW does it for you by searching the document for the first anchor available.
  3. ° on the tWF button. Choose Insert Free ID. The ID is pasted into the link.
    ^ on the Bookmark button.
  4. Go the position in the text where the anchor is going to be, but forget the ID. tW remembers it for you.
    Place the cursor on the anchor position.
  5. • on the Paste button to paste the anchor into the text. Yes, when choosing Insert Free ID the anchor was created and placed in the XClipboard.
  6. • on the Bookmark button. Choose the link you just made. Now you are at the link. Switch to Viewer mode, and tap on the link. If the Viewer jumps to the link, it works, otherwise a message saying “Anchor # not found”.
    Switch to Editor mode. Go back to the link by • on the Bookmark button and choosing the link. Make a backspace when the cursor appears beside the bookmark charachter. That's it!


It also works fine to start with the anchor instead of the link.

*Be sure to only create one complete link at the time (link and anchor). The Insert Free ID function needs the anchors to be inserted into the text to be able to give the right ID for the following link.

Getting Started
Importing from, and exporting to Memo
tW does not have any native functions for import or export of memos. Instead it has the capability of launching daMemoPad as if it was part of tW. daMemoPad offers the import and export functions for memos that tW lacks, plus a little more.

Importing from Memo
  1. Make sure daMemoPad is installed.
  2. Place the cursor in the doc you want to import the Memo to.
  3. > on the Paste button to launch daMemoPad.
  4. Choose category in upper right corner, then select the memo to open.
  5. Tap on the I button. The whole contents of the memo is pasted into the doc. In case you only want to import a part of the memo, select this part before tapping on the I button.
  6. Tap on the Q button to close daMemoPad.


Exporting to Memo
  1. Make sure daMemoPad is installed.
  2. Select the text to export in the doc. Use Palm standard selection method.
    Note: daMemoPad does not accept XSelection.
  3. > on the Paste button to launch daMemoPad.
  4. The text is exported.
  5. Tap on the Q button to close daMemoPad.


You export up to 32kb at the time with this method. It all goes into one memo on my T|T5. When testing it on my T|T with a document of 14kb, it also went into ONE memo! Don't ask me how that was possible—T|T only has 4kb records. But the whole 14kb was later editable in MemoPad itself. Can anyone explain this to me?
Getting Started
Encrypting text files
tejpWriter allows you to save your text files encrypted on the memory card using the American Encryption Standard, AES if AESLib.prc is installed. Either 16 or 32 characters keys (128 bits or 256 bits) can be used. Of course, the longer the key, the safer the encryption. To make it even safer, tW is also using Cipher Block Chaining, CBC. For maximum security, tW can hash the key, (scramble it into a digest) making it maximum size even if the password entered is short. For this, ensure that SHALib.prc is installed. If you don't install SHALib.prc, the encryption will still work, but the entered password may become a security risk since it's not shielded with the hash.
Warning! A document encrypted with SHALib.prc installed, cannot be opened if SHALib.prc is not installed, or the other way around! The same password, produces different the keys depending on if SHALib.prc is installed or not.

How to save a document as an encrypted text file
  1. Ensure AESLib and SHALib are installed. Do not uninstall them again unless you have decrypted all your text files.
  2. Choose 128 bits or 256 bits keys under Menu/Setup/General. There you can also check Tag file extension if you want to be able to see if the file is encrypted. A "•" is then appended to
    the filename if possible.
  3. > on the Save button, or choose Menu/Doc/Save as.
  4. Tap on the AES push button, and then save it as you normally would.
  5. Enter a password when prompted. A long password is safer, but don't forget it. There is no way to recover it! Tap the OK button when you have memorized the password.


How to Load an encrypted text file
  1. Make sure that steps 1 and 2 above are OK.
  2. Drag right on the Load button. Select the encrypted file, then tap on the Load button.
  3. Enter the same password you entered when saving the file. Tap on the OK button. If you don't remember the password there is no way to recover it!



Warning! You are using the encryption at your own risk!


4 The Editor


  1. The Menu
    Doc: New Open Filter Rename Close Previous Information Send Load Unload Save Save as
    Edit: Undo Trash List Cut Copy Paste Clip List Phrase List Go to Find & Replace
    Setup: General Behavior Doc List Filter Editor Viewer Ctrl Characters Bookmarks Statistics HTML Export Word Lookup
    Tools: Statistics Duplicate Compress & Close HTML Export
    +: Viewer Toolbar Statusbar Thumbboard Tapboard
    ?: About
    VFS-File: Rename Delete
    VFS-Folder: Set as Home Create Rename Delete

  2. The Toolbar
    Upper Row Buttons: Document Mini Display Scrollbar Line Up Page Up
    Lower Row Buttons: Save Visual Bookmarks Find Marks Copy Paste Undo Case Embrace tWF Word Lookup Line Down Page Down

  3. The 5way Navigator
    Center Up Down Left Right

  4. Version Control
  5. Marks
    Introduction The Reference Mark The Selection Mark

  6. The XClipboard
  7. The Tapboard
  8. The Thumbboard
  9. External Keyboard Adaptation
  10. Typing rates


4a The Menu

The Editor/The Menu
Doc/New - N
Closes any open doc and creates a new one.
-Enter the name (max 31 characters).
The Editor/The Menu
Doc/Open - O
Pops up the "Document List" with the docs loaded in RAM. The list is filtered according to file extension. See Menu/Doc/Filter below.
The Editor/The Menu
Doc/Filter - F
Decides which file types is to be shown in the "Document List". "All" means all docs. ".---" means only files without extension. Which extensions that appears in the list, and in which order is setup in Menu/Setup/Doc List Filter.
If XClipboard is used also:
"Clips" is a list of clipboard docs with extension ".clp".
"Trash" is a list of deleted text as docs with extension ".tra".
"Phrases" is a list of phrases as docs with extension ".phr".
The Editor/The Menu
Doc/Rename - R
Renames the opened doc.
-Enter the new, unique name.
The Editor/The Menu
Doc/Close - E
Closes the opened doc.
The Editor/The Menu
Doc/Previous - V
Switches to the previously closed doc.
The Editor/The Menu
Doc/Information - I
Displays the following information about the opened doc:

Data about the original text file on memory card.
The Editor/The Menu
Doc/Send
Beams the opened doc as a text file to another PDA or sends it with Bluetooth, SMS, or email.
The Editor/The Menu
Doc/Load - L
Loads a text file from a VFS memory card and transforms it into a doc in RAM.


Done
Closes the Load form.

Load
Loads the file as a doc file into RAM, saves the options to be used the next time, and closes the form.
The Editor/The Menu
Doc/Unload - D
Removes the opened doc from RAM.
The Editor/The Menu
Doc/Save - S
Saves the opened doc to memory card as a text file or doc database, using the save path and save format stored in the document at Load time and at each Save as. If the doc is new or has never been loaded or saved, the Save as form comes up. This function is used when saving new documents, when saving under another name or in another folder, or when saving in another file format than before.
The Editor/The Menu
Doc/Save as - A
Saves a doc as a text file on the memory card.


Done
Closes the form.

Save
Executes the Save as operation, saves the options to be used the next time, and closes the form.
The Editor/The Menu
Edit/Undo - U
Undoes the last operation.
*If the XClipboard is checked, the XUndo will be used. It can undo the 32 last operations.

The Editor/The Menu
Edit/Trash List - H
Brings up the Trash List from which you can paste the latest trash back into the text.
*Only available if the XClipboard is checked.

The Editor/The Menu
Edit/Cut - X
Cuts out the selected text and copies it into the local clipboard.
The Editor/The Menu
Edit/Copy - C
Copies the selected text to the local clipboard.
The Editor/The Menu
Edit/Paste - P
Pastes the text from local clipboard.
*If XClipboard is set, the last text copied or cut is pasted.

The Editor/The Menu
Edit/Clip List - B
Brings up the Clip List from which you can choose among the latest "Cuts" or "Copies" to paste into the text.
*Only available if XClipboard is set. See Menu/Setup/Editor.

The Editor/The Menu
Edit/Phrase List - J
Brings up the Phrase List from which you can choose among your preprogrammed phrases to paste into the text.
*Only available if XClipboard is set. See Menu/Setup/Editor.

The Editor/The Menu
Edit/Go to - G
See "Info" in "Go to" form.
The Editor/The Menu
Edit/Find/Replace - F
Find
Type the word or phrase you want to find in the field to the right (max 31 char).
If there was any selection when opening the Find & Replace form, it will automatically be filled in.
The field consists of two lines to make it possible to include a linefeed. Tapping Find will show the next match of the Find field contents, highlighted on the first line. During search, the Find & Replace window stays open. If no match is found, the window closes.

Replace
Replaces the found match with the contents of the Replace field.

M (Manual)
When having pressed Replace a new Find is normally performed. With M selected this Find is suppressed, allowing you to see the replacement.

All
Replaces all matches in the whole text with out stopping.

Cancel
Cancels any Find & Replace operation and closes the Find & Replace form.
* Has no effect on Replace All.
* Tapping outside the Find & Replace window works as a Cancel.


Top
When set, starts Find from the top of the document.
* Has no effect when Replace All.


Case
When set, only finds word or phrases matching exact case.

Word
When set, only finds word or phrases surrounded by white spaces (spaces, punctuation marks, or linefeeds).
The Editor/The Menu
Setup/General
Theme
Set up the colors of the 9 customizable Color Themes by first selecting the Color Theme tapping on the arrow buttons and then pressing "Cfg".
Tap on the Color Theme name to change it.

*To select which Color Theme to be used, drag up on the Toolbar "F" button, the second button from the left in the bottom row.

Toolbar Skin
Tap on the drop-down to select which of the skins installed in RAM to use. At least one skin has to be installed in RAM.

Encryption
Choose which encryption to use, 128 bit (16 characters key) or 256 bits (32 characters key) which is the most secure.
Only available if AESLib is installed.


Tag file extension
If checked, places a bullet, "•", after the original file name to show which file is encrypted.
Only available if AESLib is installed.

The Editor/The Menu
Setup/Behavior
Beep on important messages
Still for future use. :)

Confirm delete of docs
Displays a confirmation dialog when deleting docs from RAM.

Confirm overwrite on save
Displays a confirmation dialog when overwriting text files on memory card.

Confirm overwrite on load
Displays a confirmation dialog when overwrite docs in RAM.

Popup info
Displays popup info. Default display time is 500ms.

Startup

Invert Portrait
Turns the display upside-down when in portrait mode.
This feature is useful when you need to have better control over the 5way Navigator, at the same time as inputting Graffiti. Ex TealScript with Write Anywhere controlled by the 5way Navigator.
*Some forms, like the Tips, and dialogs, are not adapted to this feature and will therefore be displayed without invertion.


Beam/Send
Decides the function of the Menu/Doc/Beam-Send item. Use one of the Send formats to send the doc with VersaMail or Snappermail.
The Editor/The Menu
Setup/Doc List Filter
Enter the file extensions you want to use, in the order they should appear in the Filter list after the "All" and ".---" entries.
The Editor/The Menu
Setup/Editor
Ruled
Makes the editor field ruled.

Auto Shift
Sets the Palm standard autoshift option.

Moving Cursor
When making line-up or line-down this option instead makes cursor-up or cursor-down.

Smart Word Select
(Smart W Sel) Automatically selects a word if the cursor is just before the word, inside it, or right after it leaving no spaces between the cursor and the word.

Version Control
(Version Ctrl) Keeps track on which of the texts has the latest modifications—the doc in RAM or the original text file on the memory card—so that a later version isn't overwritten by mistake when Loading or Saving.

Tbd layout
(Tapboard/Thumbboard layout) Available layouts: QWERTY, QWERTZ, and AZERTY.
*The Tapboard/Thumbboard only supports Latin 1 character set.


Auto Indent
Simulates indent by inserting space characters or a tab after linefeed.

XClipboard
This is the new flexible doc based clipboard with the amount of available RAM as the only restriction. It includes a configurable number of items in the Clip List, Trash List, and Phrase List, and a powerful Undo.

Size
The number of items in the clipboard lists. Keep this number low if you need to save RAM.

Cleanup
Deletes all XClipboard docs when exiting.

Kbd Fix
(Keyboard Fix) Helps entering characters which are missing on the keyboard or helps speeding up and simplifying entering characters which normally are complicated to enter.
The Keyboard Fix lets you enter 16 configurable characters by typing a two-character combination without time limit:
The default setup:

Ellipsis: . + .
Em dash: - + -
Left single smart quote: ' + (
Right single smart quote: ' + )
Left double smart quote: " + (
Right double smart quote: " + )
Lower case c - cedilla: , + c
Upper case C - cedilla: , + C

Setup string: .....--—'(‘')’"(“")”,cç,CÇ


The Setup string consist of maximum 16 groups with 3 characters in each. The first two characters in each group, are the two-character combination to be typed to enter the third character.
Ex 1. A person living in Spain, having an American keyboard may want to enter "¿" by typing two "?" after each other. To do this add "??¿" to the Setup string.
Ex 2. A person living in Germany, having a standard "Qwerty" keyboard, may want to enter "ü" by typing two "u" after each other. To do this add "uuü" to the Setup string.
*Tips: Choose character combinations which normally aren't used, like punctuation characters, which usually are followed by a space, in combination with letters. Ex: "," and "C" to make "Ç" or ":" and "o" to make "ö".
*The Keyboard Fix can be used together with all types of character input—not only an external keyboard.
*Only available with the XClipboard.

The Editor/The Menu
Setup/The Viewer

The Editor/The Menu
Setup/Ctrl Characters

The Editor/The Menu
Setup/Bookmarks
Override doc character
The Dynamic Bookmark character can be specified in two ways: either in tWriter or in the doc. The doc character normally has higher priority, but can overridden by setting this option.
*To set the Dynamic Bookmark character in the doc, place it surrounded by "<" and ">" as the last characters in the doc.

Sort list alphabetically
Sorts the bookmark list.
The Editor/The Menu
Setup/Statistics
Char/Line
Maximum number of characters allowed per line when simulating page count.

Lines/Page
Maximum number of lines allowed per page when simulating page count.

Alt characters
An alternative set of 9 configurable characters to be displaced in the right column.
The Editor/The Menu
Setup/HTML Export
The HTML 4.01 export options:

Insert Meta Template
If set, inserts the most commonly used Meta tags into the Head. They are, however, only templates needing to be completed with the missing infomation.

Margin
Inserts a margin on all around.
See HTML 4.01 stylesheets manuals for more info on what values to use.

Indent
If set, indents all paragraphs starting with a tab character or one or more space characters. The amount of the indent is by default 1em.
See HTML 4.01 stylesheets manuals for more info on what values to use.

>2 LFs inserts <P> tag
Two linefeeds in a row, inserts a <P> tag instead of two <BR> tags.

Headline
The font style of the Headlines.

Body
The font style of the text in the Body.

A Link
The color of the active link.

V Link
The color of the visited link.
The Editor/The Menu
Word Lookup
Drag up
Enter the database name of the application, or DA to be launched when dragging up on the Word Lookup button. Do not include ".prc".
If the field is left empty, the Commandbar comes up so that any memory resident programs with icons on it can be launched.

Drag right
Enter the database name of the application, or DA to be launched when dragging right on the Word Lookup button. Do not include ".prc".
If the field is left empty, the Commandbar comes up so that any memory resident programs with icons on it can be launched.

Drag left
Enter the database name of the application, or DA to be launched when dragging left on the Word Lookup button. Do not include ".prc".
If the field is left empty, the Commandbar comes up so that any memory resident programs with icons on it can be launched.
The Editor/The Menu
Tools/Statistics
Characters
The total number of characters not counting characters used for indenting. This number may or may not equal Text size on the Mini Display.

Chars wo spaces
The total number of characters not counting spaces

Words estimated
The total number of characters divided by 6—a common estimation accepted by editors.

Words counted
The number of words counted.

Numbers
The number of numbers. :-)

Paragraphs
The total number of paragraphs. Empty lines only containing spaces and/or tabs are not counted.

Empty lines
Lines only containing spaces, tabs or nothing at all.

Lines
A simulated value of how many lines a text will have depending on the Chars/Line setting in Menu/Setup/Statistics.

Pages
A simulated value of how many page a text will have depending on the Lines simulation and Lines/Page setting in Menu/Setup/Statistics.

Copy
Copies the essential values together with file name and date into the operative systems clipboard.
The Editor/The Menu
Tools/Duplicate
Duplicates the doc giving it the name Duplicate.txt
The Editor/The Menu
Tools/Compress & Close
Compresses the doc and when ready closes it.
The Editor/The Menu
Tools/HTML Export
Exports the opened doc, containing tWF or not, to HTML 4.01 format.

Normal linefeeds puts in <BR> tags. Because of the basic differences between the tW Format and HTML, sometimes it may be necessary to manipulate the linefeeds. tWF supports two ways of doing that:

The Editor/The Menu
+/Viewer - Q
Switch to Viewer.
The Editor/The Menu
+/Toolbar - W
Hides the Toolbar. To show the Toolbar again, tap and hold on the screen.
The Editor/The Menu
+/Statusbar - Z
Toggles the Statusbar on or off.
* Only available on Palms with 480x320 pixels display like T|T3, T|T5, LifeDrive, and TX.

The Editor/The Menu
+/Thumbboard - M
Rotates the screen if necessary, hides the DIA and the Statusbar, and turns on the Thumbboard.
* Only available on Palms with 480x320 pixels display like T|T3, T|T5, LifeDrive, and TX.

The Editor/The Menu
+/Tapboard - K
Toggles the Tapboard on or off.
An other way to close the Tapboard is by pressing "Alt" +"Close".
The Editor/The Menu
?/About
The first line shows the application name and version. The second line the date and time of when it was built and if it is a beta release.
After that it tells you it's an open source freeware released under GNU General Public Licence. For more information visit http://www.gnu.org
The only thing I charge is that you make good use of it.
The Editor/The Menu
VFS-File/Rename
Renames the highlighted file in the list.
The Editor/The Menu
VFS-File/Delete
Deletes the highlighted file in the list.
If Menu/Setup/Behavior/Confirm delete of files is set, a confirmation dialog will appear before the deletion is executed.
The Editor/The Menu
VFS-Folder/Set as Home
Sets the presently opened folder as Home folder. The Home folder is always reachable by tapping on the Home button, giving an oportunity to jump between the Home folder and the Start folder. When you have jumped to the Home folder the Home button changes its icon to a star bringing you back to the Start folder.
The Editor/The Menu
VFS-Folder/Create
Creates a new folder inside the presently opened folder.
The Editor/The Menu
VFS-Folder/Rename
Renames the presently opened folder.
The Editor/The Menu
VFS-Folder/Delete
Deletes the presently opened folder if it is empty.

4b The Toolbar

Each of the toolbar buttons can have up to five Fast Functions and an unlimited number of Secondary Functions tied to it.

Toolbar Legend



• Simple tap.

^ Place the stylus on the button and drag up until it's above the button, then lift the stylus.

v Place the stylus on the button and drag down until it's below the button, then lift the stylus.

< Place the stylus on the button and drag left until it's beside the button, then lift the stylus.

> Place the stylus on the button and drag right until it's beside the button, then lift the stylus.

° Tap and hold.

The Editor/Toolbar
Document (First button upper row)
• Documents
Displays a list with the available docs in RAM.
Select which document to open by tapping on it. Close document by tapping on the highlighted document.

^ Extension Filter
Decides which file types is to be shown in the "Document List".
"All" means show all extensions, and ".---" means only show files without extension.
Which extensions that appears in the list, and in which order is setup in "Menu/Setup/Doc List Filter".

v Previous doc
Switches to the last closed document with cursor positions, selections, and marks maintained. Closing a document and then opening it again, makes it possible to switch between two different places in the same document.

> Load
Loads text-file or doc database from memory card.

° Pop-up menu
The Editor/Toolbar
Mini Display (Second button upper row)
• Display Mode
Changes display mode to:


*When cursor is visible, the Position char, and Position % represents the cursor position, otherwise they represent the position of the first character on the first line.
*The word count is calculated as the number of characters divided by 6—a common estimation accepted by editors.

^ Switch mode
Switches between Editor and Viewer.

v Hide Toolbar
Hides the Toolbar. To show the Toolbar again, tap and hold on the screen.

< Tapboard
Toggles the Tapboard on or off.
An other way to close the Tapboard is by pressing "Alt" +"Close".

> Thumbboard
Rotates the screen if necessary, hides the DIA and the Statusbar, and turns on the Thumbboard.
* Available on Palms with 480x320 pixels display like T5, LifeDrive, TX.

° Pop-up menu
Secondary Functions:


Statusbar
Toggles the Statusbar on or off.
* Available on Palms with DIA.

The Editor/Toolbar
Scrollbar (Third button upper row)
• Go to approximate position
Positions the cursor at a position in the text corresponding to the tapped position of the scrollbar.

< Go to BOT
Places the cursor in the Beginning Of Text.

> Go to EOT
Places the cursor at the End Of Text.
The Editor/Toolbar
Line Up (Forth button upper row)
• Line Up
Scrolls the text one Line Up

° Repeat
Repeats the line up command

The Editor/Toolbar
Page Up (Fifth button upper row)
• Page up
Scrolls one Page Up

° Repeat
Repeats the page up command
The Editor/Toolbar
Save (First button lower row)
• Save
Saves opened doc file to memory card as a text file or a doc database.
The save path and save format are stored in the document database at "Load" time and at each "Save as". The document will overwrite the old document when "Save" is tapped. If the doc is new or has never been loaded or saved, the "Save as" form comes up.

> Save as
Brings up the Save as form.
The Editor/Toolbar
Visual (Second button lower row)
Font and Color Theme selector.

• Favorite
Selects the Favorite Font and Color Theme combination as set using Set Favorite in pop-up menu below.

^ Color Theme
Pops up the Color Theme List with the used Color Theme selected.
Select a Color Theme to use by tapping on it.

v Font
Pops up the Font List with the used Font selected.
Select a Font to use by tapping on it.

° Pop-up menu
Secondary Functions:
System Default
System default sets the colors and font to system originals.

Set Favorite
Set Favorite sets the present font and Color theme as Favorite.
*See Menu/Setup/Color Themes on how to configure the Color themes.

The Editor/Toolbar
Bookmarks (Third button lower row)
• Bookmarks
Pops up the Bookmark List.
Tap on the name of a bookmark in the list and the cursor will be placed immediately before the bookmarked word, and after the bookmark character. To delete the bookmark character, make a backspace.
See Menu/Setup/Bookmarks.

^ Add
Adds a bookmark character immediately before a chosen word.
—Place the cursor in contact with the word to bookmark, meaning just before the word, inside the word, or right after the word, leaving no space between it and the cursor, then do ^.
See Menu/Setup/Ctrl Characters to configure bookmark character.

v Stamp
Stamps the doc with the bookmark character at the end of the doc, embraced by "less than" - "greater than" marks. This normally overrides the bookmark character as setup in Menu/Setup/Ctrl Characters.

° Pop-up menu
The Editor/Toolbar
Find (Forth button lower row)
• Find & Replace
Brings up the "Find & Replace" form.

^ Quick Find
A way of finding the next occurrence of a selected word or phrase, without bringing up the Find & Replace form.
—Select a word or phase (max 31 char) and do ^. Highlights any match in the text below. If not "Auto select word" is checked, and no word is selected, it uses last word searched for in the "Find & Replace". See Menu/Setup/Editor.
Quick Find is dependent on the "Case" and "Word" settings from the "Find & Replace" form.
The Editor/Toolbar
Marks (Fifth button lower row)
• Select
Sets or Removes the Selection Mark. When The Selection Mark is set, the button icon is substituted with a red "record" dot.

v Selection Jump
Jumps between the Selection Mark and the cursor position.

< Reference Set
Sets the Reference Mark

> Reference Jump
Jumps between the Reference Mark and the cursor position.

° Pop-up menu
Secondary Functions:


Reference Rem
Removes the Reference Mark

The Editor/Toolbar
Copy (Sixth button lower row)
• Copy
Copies the selected text to the local clipboard.

^ Cut
Cuts out the selected text and copies it into the local clipboard.

° Pop-up menu

* If Smart Word Select is set and the cursor is just before a word, inside a word, or right after a word, the word is automatically selected before the "Copy" or "Cut" is executed.
*If XClipboard is set the amount of available RAM is he only limit on how much text tW can copy.
*If XClipboard is not set, the local clipboard has a capacity of max. 32 kb.

The Editor/Toolbar
Paste (Seventh button lower row)
• Paste
Pastes the text from local clipboard.
*If XClipboard is set, the last text copied or cut is pasted.


^ Clip List
Brings up the Clip List from which you can choose among the latest "Cuts" or "Copies" to paste into the text.
*Only available if XClipboard is set. See Menu/Setup/Editor.


v Phrase List
Brings up the Phrase List from which you can choose among your preprogrammed phrases to paste into the text.
*Only available if XClipboard is set. See Menu/Setup/Editor.


< AsciiPopDA
Launches the Desktop Acessory AsciiPopDA, if it is installed.

> daMemoPad
Launches the Desktop Acessory daMemoPad, if it is installed.

° Pop-up menu
The Editor/Toolbar
Undo (Eighth button lower row)
• Undo
Undoes the last operation.
*If the XClipboard is checked, the XUndo will be used. It can undo the 32 last operations.


^ Trash
Brings up the Trash List from which you can paste the latest trash back into the text.
*Only available if the XClipboard is checked.


° Pop-up menu
The Editor/Toolbar
Case (Ninth button lower row)

*Works with Smart Word Select.
• Invert
Inverts the case of a selection.

^ Upper
Sets the case of a selection to upper case.

v Lower
Sets the case of a selection to lower case.

v Title
Sets a selection to titlecase, all words with leading character in uppercase, and the rest in lowercase.

v Sentence
Sets a selection to sentencecase, the first word's leading character in uppercase, and the rest in lowercase.

° Pop-up menu
The Editor/Toolbar
Embrace (Tenth button lower row)

*Works with Smart Word Select.
Places a selection inside the following marks, embracing them:

• Parenthesis ()
Parenthesis.

^ Single QM
Single Quotation Marks.

v Double QM
Double Quotation Marks.

< Single SQM
Single Smart Quotation Marks.

> Double SQM
Double Smart Quotation Marks.

° Pop-up menu
Secondary Functions:
Single AB
Single Angular Brackets.

Double AB
Double Angular Brackets.

LT- GT
Less Than - Greater Than marks.

Curly Brackets
Curly Brackets.

Square Brackets
Square Brackets.

The Editor/Toolbar
tWF (Thirteenth button lower row)
Helps to insert the right tW Format codes.

•Italic
Marks a selected word or phrase as italic.
*Works with Smart Word Select


^ Bold
Marks a selected word or phrase as bold.
*Works with Smart Word Select


v PCC
Inserts the Paragraph Control Character at the cursor position.

<Internal Link

The Editor/Toolbar
Word Lookup (Fourteenth button lower row)
Contains a collection of word lookup function for external dictionaries. All lookup functions make use of Smart Word To automatically select the word at the cursor position if no selection already is made, and then copy it to the Palm OS clipboard, before they are executed.
*Smart Word Select needs to be set. See Menu/Setup/Editor/Smart W Sel.


•?
Reserved for future use.

^ External Lookup
Launches a normal application, a DA (Desktop Acessory), or brings up the Commandbar giving access to external dictionaries making use of memory resident commandbar launch. Configured under Menu/Setup/Word Lookup/Drag up.

v ?
Reserved for future use.

< External Lookup
Launches a normal application, a DA (Desktop Acessory), or brings up the Commandbar giving access to external dictionaries making use of memory resident commandbar launch. Configured under Menu/Setup/Word Lookup/Drag left.

> External Lookup
Launches a normal application, a DA (Desktop Acessory), or brings up the Commandbar giving access to external dictionaries making use of memory resident commandbar launch. Configured under Menu/Setup/Word Lookup/Drag right.
The Editor/Toolbar
Line Down (Thirteenth button lower row)
• Line Down
Scrolls the text one Line Down


° Repeat
Repeats the Line Down command
The Editor/Toolbar
Page Down (Fourteenth button lower row)
• Page Down
Scrolls one Page Down

° Repeat
Repeats the Page Down command

4c The 5way Navigator

The Editor/5way Navigator
Center
Single press: Toggles the scroll function of the Up and Down buttons—one line or page minus one line.
Double-press: Switches between Editor and Viewer
The Editor/5way Navigator
Up
Scrolls the page up one line or one page minus one line.
The Editor/5way Navigator
Down
Scrolls the page down one line or one page minus one line.
The Editor/5way Navigator
Left
Moves cursor one position to the left
The Editor/5way Navigator
Right
Moves cursor one position to the right

4d Version Control

tejpWriter is a Palm docs based editor. The advantage with this is that you have immediate access to the docs you have loaded from the memory card. You only have to load a doc once. It may remain in RAM until you have finished working on it. Then you Save it for the last time and Unload it from the RAM.
To maintain the original copy on the memory card updated during this time, you only have to save the doc. This means you will have two copies of the same document. Version Control helps you keep track on which of these docs is the most recent version. This is necessary to prevent the user from by mistake overwriting the latest version and loosing valuable data. VC checks the versions each time a doc is loaded, saved or opened. The same check is made when entering editor mode.
When the docs are loaded or saved, they get stamped with information about the original document on the memory card. This information is then used to retrieve the modified date of the original document. See Menu/File/Information.
To turn on and off the VC see Menu/Setup/Editor.
The Card button on the toolbar indicates when the VC is on. VC will only complain when something is wrong. VC does not check XClips, XPhrases, or XTrash.
The Editor

4e Marks

The Editor/Marks
Introduction
From version 3.00 the editor has two positions that can be marked—the Reference Mark and the Selection Mark.
The Reference Mark and the Selection Mark are fixed in the sens that they do not move around when jumping to them as the mark did in previous versions. They stay where they are as long as the database remains in RAM, until another position is marked, or until the marks are removed.
The Editor/Marks
The Reference Mark
The Reference Mark is used to mark a stationary position in the doc, for example where you start your work for the day. Words to ref in the MiniDisplay can then be used to count the number of words written during the day. If no Reference Mark is set the MiniDisplay option will say: "No ref".
The Editor/Marks
The Selection Mark
The Selection Mark is used to select text to be copied to the XClipboard—a powerful doc based clipboard with the RAM setting the limit. It is a complement to the normal way of selecting text to make it allow selections 64kb. The normal type of selection is, however, recommended up to 32kb only.
The Selection Mark marks the start of a selection while the cursor position marks the end of it. No highlighting needed, but when the Selection Mark is set by tapping the "X" button on the Toolbar, the "X" icon is substituted by a red dot as used to indicate recording on a tape recorder.
To clear the Selection Mark and the record icon, perform one of the XClipboard operations, or by tap the "X" button again.

4f The XClipboard

XCopy transfers text in any normal selection, or between the Selection Mark and the cursor, to a Palm doc with the file extension .clp for Clip. After choosing a Clip from the Clip List, the Clip is inserted into any doc using XPaste. The Clips are editable like any other doc, and to turn it into a normal doc, just remove the ".clp" file extension. It is, of course also possible to transform a normal doc into a Clip by changing its file extension to ".clp"
The XCopy, XCut and the XPaste are database oriented functions which is a bit sluggish when inserting a few words into a big document. They are, however, powerful when working with bigger chunks of text. You can copy and insert any text size as long as there is space in the memory.
With the XClipboard comes the Trash list where everything deleted ends up. The Trash List works just like the Clip List. You can therefore paste back old deleted material into text. The Trash docs have ".tra" as extension. The Trash is used by the Undo function.
As a spin-off there is also a Phrase List where it's possible to store phrases often used. The Phrase docs have the extension ".phr".
Connected to the XClipboard is the Undo log, which for the moment stores the last 32 operations. An operation is one entered character, one deleted character, a chunk of text Cut or deleted, or a chunk of text Pasted. As two operations count a character entered over a selection, or a Paste over a selection. This means, for example, that at the most 32 entered characters can be undone by tapping the Undo button 32 times, or, for example, at the most 32 Pastes undone. This number can not, however, exceed the number of list items declared in Menu/Setup/Editor-XClipboard list.

An example of the flexibility of the XClipboard
Suppose you have written a novel with each chapter as a separate document, and now you would like to mount them in the same document.
Rename the file name of the first chapter by putting the file extension .clp after the original name. Create a new document. Drag up on the Paste button and choose your chapter from the Clip List to paste it into the new doc. Rename the next chapter the same way, and paste it into the new doc after the first chapter. Repeat the procedure with all chapters.

To use the conventional type of clipboard uncheck Menu/Setup/Editor/XClipboard.
The Editor

4g The Tapboard

The tejpWriter Tapboard differs from the Palm OS built-in keyboard in many ways. The Tapboard is a bit bigger, more intuitive, and MUCH faster. It may not look very special at first, but after having gotten acquainted with it, you will see the speed.

The Editor

4h The Thumbboard

For Palms with 480x320 pixels screens, there is a Thumbboard available. It is a larger version of the Tapboard with almost the same functionality. Although it is not a replacement for an external keyboard, it is considerably faster to write with than using Graffiti or the Tapboard. It is excellent for people who wants to travel light and for people who needs to write in the dark.
To access the Thumbboard choose: Menu/+/Thumbboard. To close the Thumbboard, press "Alt" + "Close".
To switch between Thumbboard and the Viewer, double press on the 5way navigator "Center" button.

The Thumbboard does not give you access the the whole editor interface, but with Menu/Setup/Editor/XClipboard enabled, it does give you the most vital part of it—the XClipboard. You can select, copy, cut, paste, and undo. And you use Smart Word Select.

Undo
The Undo is available on the button between the Space buttton and the Enter button. With it you can undo up to 32 oparational steps.

How to enter the XClipboard Mode
Press the 5Way Navigator Center Button. Three buttons on the lower row will change labels to Copy, Cut, and Paste. To exit the XClipboard mode without any operation just press 5Way Navigator Center Button again.

How to select text
1. Enter the XClipboard mode.
2. Use the 5Way Navigator Center Button as you would to move the cursor, but now instead you control the area of the selection.

How to operate on a selection
With the selection made, you can Copy or Cut the selected area, Paste something over it, or type something over it by entering any character. Doing so will automatically exit the XClipboard Mode.
*To paste something without selecting any text, you need to enter XClipboard Mode first the press the Paste button.
*As you may notice, you can not enter an uppercase character over a selection, because the Shift and the Alt functions are not available when in XClipboard Mode. The way around that problem is either to Cut the selected area and then enter the uppercase character, or to press Shift or Alt before selecting the text. The last alternative, however, counts on your ability to forsee your future actions.
The Editor

4i External Keyboard Adaptation

By making the most used operations available under the menu with shortcuts, tW is now suitable for use with external keyboard. To make life easier the Keyboard Fix helps to enter characters not available on the keyboard. The following characters for example, that are missing on the Palm Universal Wireless Keyboard, can easily be entered by typing a two-character combination without time limit:


This is the default setup, but the Keyboard Fix lets you program up to 16 characters to be entered the way you choose.
Keyboard Fix works for all types of character input, not only for external keyboards. It can be of great help to speed up the entry of characters which are complicated to enter. See more under Menu/Setup/Editor.
The Editor

4j Typing rates

It is now possible to measure the rate with which you write. Choose Toolbar/MiniDisplay/Typing CPM or Typing WPM. Every half minute the type rate is displayed as a snapshot of the typing rate during the last 30 seconds in CPM, characters per minute or WPM, words per minute. With this tool you can see yourself which mean of input is the fastest. This is what I found out:

    < 100 cpm Graffiti & built in keyboard.
    < 140 cpm the tW Tapboard
    < 170 cpm the tW Thumbboard
    < 190 cpm Palm Universal Wireless Keyboard


But of course, I'm not good at typing fast.
The Editor


5 The Viewer

The viewer uses the same user interface as the Editor. The buttons below the scrollbar, however, are specific for the viewer.

Architecture
The viewer is built around a tWF decoder, a page draw routine, and a draw position cache. The main concern when drawing a page is to draw it starting at the right position. This may sound strange, but calculating the start position is the most difficult task the viewer has and this is what makes it slow. The actual start position has to be calculated starting from the last start of paragraph or linefeed before the demanded position. Calculating the start position with a long paragraph before the wanted position can make it really slow.
Each time a page is drawn, a 4kb chunk of undecoded text is loaded. This chunk makes it possible to look ahead into the future to find the next start position, but not back into the past. Therefore a special cache containing the start positions for line-up and page-up is filled when needed. The present cache may contain up to 3 page-ups depending on screen size and font. A bigger cache takes longer to fill but may contain more page-up positions. On the other hand a small is filled faster but contains fewer page-up positions. The present cache size was found to be optimal since it's more common to make page-downs than page-ups.

The 5way Navigator

The Viewer/5way Navigator
Center
The Center button
Single press: Toggles the scroll function of the Up and Down buttons—one line or page minus one line.
Double-press: Switches between Editor and Viewer
The Viewer/5way Navigator
Up
Scrolls the page up one line or one page minus one line.
The Viewer/5way Navigator
Down
Scrolls the page down one line or one page minus one line.
The Viewer/5way Navigator
Left
Go Back to previous position.
The Viewer/5way Navigator
Right
Brings up the Bookmark list.

6 The tejpWriter Format


  1. Introduction
  2. The Paragraph Control Lines
  3. The Paragraph Control Character
  4. The Switches
  5. Placing the Switches

The tejpWriter Format
Introduction
The tW Format was designed with the following in mind:


tWF uses the normal text format as a base. This means that a space always is a space and a linefeed really a linefeed--no need to insert extra line break tags as in HTML. By default the text is Left Aligned.

What is a paragraph?
The sentences between two linefeeds. No need for paragraph tags.
The tejpWriter Format
The Paragraph Control Lines
tWF is mainly a paragraph based format acting on complete paragraphs. This is, of course, a limitation, but not as big as one may think at first. In fact you rarely need to format parts of paragraphs unless it's italic or bold. An advantage with tWF is that the formatting code only appears between paragraphs leaving the text intact and readable.
The formatting code is contained in Paragraph Control Lines (PCL's) containing three components: a Paragraph Control Character, a number of switches and a linefeed. The PCL's are invisible to the Viewer.
The tejpWriter Format
The Paragraph Control Character
The PCC tells the decoder that the following characters are switches turning on or off the different formatting options.
The PCC should be placed as the first character on a new line followed by one or more switches and a closing linefeed. If the PCC is placed inside a text it is treated as a normal character. The default PCC can be changed in Menu/Setup/Viewer.
* The Paragraph Control Character without any switches and a linfeed directly after it, inserts a linefeed seen by the Viewer, but does not insert any <BR> tag when exporting to HTML. This can be used to compensate for the automatically spacing before and after lists in HTML, since the lists in tWF does not provide any automatic spacing.


The tejpWriter Format
The Switches
All switches work in pairs except the switches for the Horizontal Rulers which doesn't need more than one. The On switch goes 'immediately before the paragraph it should format, and the matching Off switch immediately after. Any empty lines between the On and Off switches are included in the formatting. The On and Off switches all consist of white space characters chosen to make them look like they belong together.


Align
| Center On
‡ Center Off
Centers the text

¬ Right On
_ Right Off
Right aligns the text.
Only use one of the align switches at the time. If no align switch is on, left aligned is assumed.

Fonts
{ Headline On
} Headline Off
Selects a headline font as configured in Menu/Setup/Viewer.

( Small On
) Small Off
Selects a small font as configured in Menu/Setup/Viewer.

[ Mono spaced On
] Mono spaced Off
Selects a mono spaced font as configured in Menu/Setup/Viewer.
Use only one of the font switches at the time. If no font switch is on normal font is assumed.

Colors
! Highlight On
¡ Highlight Off
Paints the paragraph text and background in the highlight colors. Configurable in Menu/Setup/Looks/Theme. The colors are not fixed to the document.

% Shade On
/ Shade Off
Paints the paragraph background in a shaded tone of the normal background color if possible, otherwise a slighly lighter tone.

? Emphasize On
¿ Emphasize Off
Paints the paragraph text in the Emphasize colors. Configurable in Menu/Setup/Looks/Theme. The colors are not fixed to the document.

The Highlight and the Emphasize switches can be mixed.

Other
- Horizontal Ruler
Draws a Horizontal Ruler

“ Block Quote On
” Block Quote Off
Changes the left and right margin as configured in Menu/Setup/Viewer

‘ Comment On
’ Comment Off
Hides the text in Viewer mode

: List On
. List Off
Makes it possible to create lists with bullets (•); numbers (has to be ended with a dot); and letters (A-Z or a-z with a dot).
A list starting with a bullet is an Unordered List. Each list item has the bullet as the first character on the line followed by a space before the item text.
A list starting number or letters is an Ordered List. Each list item has a number or a letter as the first character on the line followed by a dot and a space before the item text.
Linefeeds are accepted, but not empty lines. If you want to have a visually empty line in the list, put a space character on it.
tW does not support nested lists!

This option only handles the indent. No automatic numbering or sorting. The numbers take different space depending on font choice. Configure in Menu/Setup/Viewer

HTML Export
• HTML On
· HTML Off
Inserts HTML code within these switches unaltered into the HTML document when exporting.

+ Insert <BR>
Insert a <BR> tag when exporting.

No Switch
The Paragraph Control Character without any switches and a linfeed directly after it, inserts a linefeed seen by the Viewer, but does not insert any <BR> tag when exporting to HTML. This can be used to compensate for the automatically spacing before and after lists in HTML, since the lists in tWF does not provide any automatic spacing.

The tejpWriter Format
Placing the Switches
It is possible to put more than one switch in a PCL. Combining switches gives you a reasonable flexibility when designing the document. Not all switches can be combined. Ex: Align Center and Align Right, or Block Quote and List. Experiment to find out what works.
The switches in the PCL's does not have to appear in the logical order as far as the Viewer is concerned, ex: Center Off, Right On. They can appear as: Right On, Center Off. This because the decoder sees all the switches in the PCL at what it considers the same time. But, of course it's easier to understand what is happening if they are placed in the logical order, and if you plan to export the document to HTML, then the order does matter.

The Linefeed
The linefeed tells the decoder that there are no more switches and that the PCL is ended.

Italic and Bold
Italic and bold may act on whole paragraphs as well as individual words. Therefore italic and bold do not need the otherwise necessary PCC although they may be placed on a PCL after a PCC.

Links, Anchors, and Bookmarks
Links, Anchors, and Bookmarks are completely free standing from the PCLs. They all use configurable control characters. See Menu/Setup/Ctrl Characters

A link is embraced by two link control character immediately followed by a for the document unique anchor target number. There can be at the most 150 links on a display.

The Anchor consists of a anchor control character immediately followed by a for the document unique anchor number. The TOC anchor is special. It has a reserved ID of 999.

A Bookmark control character is placed immediately before the text to be marked.

7 The Toolbar Skin


  1. Introduction
  2. How it is done
  3. Rules
  4. The skin file Tbmp layout

Toolbar Skin
Introduction
To make tejpWriter fit as many users as possible, it has a graphical toolbar made up by a number of images contained in a separate skin file. By modifying the images in this file, the toolbar and its icons can be adapted to different tastes.
Toolbar Skin
How it is done
  1. Make a copy of the original skin file using a file manager like FileZ.
  2. Copy the original skin file to a memory card, leaving the copy in your Palm's RAM.
  3. Open the skin file copy with Bird or TbmpEdit and edit the images.
  4. When you are ready, save the file and start tejpWriter. The changes will now appear on the toolbar.

Toolbar Skin
Rules

Toolbar Skin
The skin file Tbmp layout

Idle State

    Upper Row
    Doc 1000
    DocShift 1001
    DocCaps 1002
    MiniDisplay 1010
    ScrollBar 1020
    ScrollbarNoDoc 1021
    ScrollKnob 1022
    Navigation 5way Line 1030
    Navigation 5way Page 1031


    Lower Row
    Memory Card 2000
    Memory Card VC 2001
    Favorite 2010
    Bookmarks 2020
    Find 2030


    Editor
    Mark 2040
    Mark XSelection 2041
    Copy 2050
    Paste 2060
    Undo 2070
    Case 2080
    Embrace 2090
    PCC 2100
    Word Lookup 2110
    Viewer
    TOC 2055
    Back 2065
    Forward 2075

Pressed State

    Upper Row
    Doc 3000
    MiniDisplay 3010
    ScrollKnob 3020
    LineUp 3030
    PageUp 3040
    LineDown 3050
    PageDown 3060


    Lower Row
    Card 4000
    Favorite 4010
    Bookmarks 4020
    Find 4030


    Editor
    Mark 4040
    Copy 4050
    Paste 4060
    Undo 4070
    Case 4080
    Embrace 4090
    PCC 4100
    Word Lookup 4110


    Viewer
    TOC 4055
    Back 4065
    Forward 4075


    Other
    Landscape Extension 5000


The skin file also contains a string resource tSTR 1000 with the MiniDisplay text color in indexed color format (a value between 0-255).

8 Font Support


  1. Introduction
  2. Rules for font resource file
  3. How to add fonts
  4. The Tools

Font Support
Introduction
tejpWriter uses a standard Palm OS resource file to host its fonts. The name of the file is "tWfonts". It comes with seven fonts: one monospaced by Philippe Guillot, and six others borrowed from the Plucker project. tejpWriter automatically senses which fonts are included in the font file as long as the rules below are followed.
Font Support
Rules for font resource file
1. The font file must have the creator ID: "tWri" and type: "Font" but it may have any file name.

2. To be sure tejpWriter uses the right font file only ONE font file should reside in RAM. tejpWriter takes the first one it finds.

3. The font file may contain at the most 20 high resolution fonts of type: "nfnt".

4. They must have IDs in an unbroken series from 1 to maximum 20.

5. The first seven are the default fonts that comes with tW. Do not remove, or in any way change those--tW depends on them.

6. You may only add fonts starting with ID 8. The ID number determines the order in which the fonts will appear in tejpWriter.

7. The font file may also contain name resources of type: "tSTR" with the same IDs as the fonts. A tSTR with ID 3 for example, will contain the name of the font with ID 3 etc. The name appears as a pop-up information when font is selected. If no name resource is included, tejpWriter will show the font ID number.
Font Support
How to add fonts
Use a freeware program called "Bird" by Philippe Guillot to edit the font file. Copy fonts contained in other programs residing in RAM, paste them into the font file, and set the ID according to the rules above.
Another way is to use "Font Collector" by Alexander Pruss. Collect the fonts you want and export them to a Bible+ format resource file. After that use Bird to copy them to tejpWriter's font file.
Be aware of the copyright on the fonts you copy to your own tejpWriter font file. Keep them to yourself!
Font Support
The Tools
Bird can be found here: http://www.ppcompiler.org
Font Collector here: http://www.freewarepalm.com

9 The File Limit

Roderick Young, who wrote the swapping system, making it possible to handle docs larger than 64kb automatically, says in the documentation that the theoretical maximum doc size is 250mb. But theory is theory, so I decided to find out the practical maximum doc size. To my disposal, I had my Tungsten|T5 with over 20mb of free RAM and a Lexar standard 512mb SD card. Starting with the biggest doc I had, 860kb, using XClipboard, I copied the whole 860kb into the clipboard. Then, by pasting it back 11 times, I, without any problems, produced a document of 10.3mb. I edited some of the text, navigated in it using the Scrollbar, saved it to the memory card first as a database, then as a text file, and last I loaded the database into RAM, then the text file. Yes, it all worked fine. Sure, it took a long time to load the text file to RAM, 45 minutes, but it worked!
But who want's to write a book that big?

10 Known Problems

  1. The keyboard driver for Palm Universal Keyboard interferes with the application eventhandler, hampering the movement of the scrollbar. It also affects the Tapboard and the Thumbboard. No solution available except turning off the keyboard driver.

  2. Selecting large chunks of text using the standard Palm OS method impossible.
    This is due to the swapping system. When Palm doc has been edited during a long time, the records can become very small. The swapping system doesn't like that and stops swapping during the selection operation. The only cure at the moment is to save the Palm doc as a text file to the memory card, them load it back again. All records will this way get the maximum size and the selection should work better.

11 About This Document

Copyright Peter Thorstenson 2005-2006
This work is licensed under Creative Commons Attribution-NonCommercial-NoDerivs 2.5 License. To view a copy of this license, visit http://creativecommons.org/licenses/by-nc-nd/2.5/ or send a letter to Creative Commons, 543 Howard Street, 5th Floor, San Francisco, California, 94105, USA.