                                ===========
                                = NameNet = 
                                ===========

                             A personal address 
                           and database program.

                                version 1.5

                                Roger Derry

                  This is a specialised database that was 
                  written entirely for  my personal 
                  requirements.  I wanted to provide a 
                  print out  for a Filofax-style notebook 
                  but also to provide some simple  search 
                  and correlation facilities for when the 
                  Atari was  available. I did not want to 
                  go to the expense of buying a full scale 
                  database that would either not do what I 
                  wanted or would provide lots of 
                  facilities that I would never use.

             Roger Derry, 38 Leopold Road, Bristol BS6 5BS, UK. 

Send a cheque for #10 to register. In return you will receive a disk with 
the latest version that includes the ability to export, import and merge 
files.

The Program
===========

NameNet  will work in either Medium Resolution colour or in High  Resolution 
monochrome.  It will not work in Low Resolution. In colour mode there  is  a 
choice  of using the program's own livery or the colours already set on  the 
desk top.

Each  entry  is stored alphabetically by `surname'. identical  surnames  are 
stored in order of `first name'. `First name' and `surname' are in quotes as 
NameNet is designed to handle other entries than people. 

Each  entry is tagged with one of several attributes such as:   whether  the 
entry  refers  to a person, a company, a service or, maybe, is  just  a  key 
word.  In version 1.5 no great use is made of this except for  providing  an 
apropriatish icon for the display. 

More  importantly  each entry has a classification tag that consists   of  a 
selection  of  32 different classifications that can be configured   by  the 
user. Is the entry a person? Do I send him, her or it  a Christmas card etc?

The  entries  shown  or  printed  out can  be  selected   by  filtering  the 
classifications  by choosing what items must be included and what items  are 
excluded from the search. 

Links
Additionally  each  item  can be linked to any number  of  others.   So  for 
example you can set up a key word `Computer Soc EC' and link all the  people 
on the executive committee to that entry. The  links are shown in  auxiliary 
windows.  The  links are called up and down. The  linking  operation  always 
selects  down links from calling entries. The calling entry then appears  as 
an up link in the called entry. 

In  the  case I have just cited the `Computer Soc EC' entry might  show  the 
names  of the committee members in the up link window. If you then  examined 
each  committee member's entry you find the Computer Soc EC entered  in  the 
down link window. I said `might' because that is the convention I use. There 
is nothing to prevent you running links the other way so that each person is 
up-linked  to  the  committee and appear as down links  on  the  committee's 
entry. There is nothing to stop you doing it both ways although there  would 
be little advantage in this. 

There  are  deliberately as few rules as possible to allow users  to  follow 
their  own  conventions. The one I use is that people come  first.  So  Fred 
Smith's down links show the company he works for and that he is a member  of 
the Computer Soc EC. I am not particularly rigourous about this and tend  to 
make,  say,  a company's sales agents a down link from the company's  entry. 
It  not that I have anything against sales agents its just that  it  somehow 
seems more logical, for me, that way.

In  the  up and down link windows the first name and  surnames  are  `folded 
under'.  If they are longer than the space available they are ended  with  a 
right arrow symbol to show that there is a continuation to the text.

Company Sales Agents
Obviously a use for links is being able to look up a company name and to  be 
reminded of the names of the people working for it. For a Sales Rep. I would 
probably only have their name and perhaps a direct dial telephone number  in 
their  entry. Their contact address would be the same as the company that  I 
can look up by going straight to the link.
 
When the company moves I only have to change one address. If the sales agent 
moves  I  often  already have their new company listed and it  is  merely  a 
matter  of readjusting their links. Up to 7 links are displayed in  each  of 
the  link windows. If there are more than that the window will  merely  show 
how many links there are. (I have one entry - the firm I used to work for  - 
where  there are 167 links!). This is done to reduce the time the  programme 
takes in setting up the links when merely browsing though the file. 

Clicking on the window will cause the links to be found. You can then scroll 
through  the  list using the GEM slider. Double clicking on  an  entry  will 
cause  that entry only to be displayed. You can then click on links on  that 
entry  to move to another linked entry. This is fine for browsing  but  more 
useful is that it is also possible to  load the display array with only  the 
linked entries from an entry. This would allow  you, in my example, then  to 
print out the committee list either to paper or, usually more helpful, to  a 
disk file. The file can  contain printer codes, it can be ASCII or it can be 
output in  1st Word format to allow editing in most word processors. You can 
select what information from each entry is output if you wish. 

The  Merge   File  output  is a special output of  names  and  addresses  in  
Calligrapher mail merge format. 

Information Entered.
When  information  is entered a dialogue form is used. All the  entries  are 
optional except that a ``Surname'' and an attribute must be entered.

Automatic  capitalisation of the first letter of each word is used  in  some 
entries. The surname entry puts the keyboard into caps lock status but lower 
case  can be entered by using the caps lock keys in the normal way  allowing 
`Mac' `Mc' `de' to be used. A later version will make this adjustable by the 
user  while  still sorting by uppercase. In this version,  entries  will  be 
sorted  in the order Mac,MC,MUD,Mc. I plan, in a later version, to  put  all 
the variants on `Mac' together in the alphabetical list.

The entries are:

First name
This is entirely optional, as are all the entries except:

Surname.
This  is the field that is sorted alphabetically (There is a secondary  sort 
that places identical surnames in order of first name).

Remark. 
This is a short entry that appears after the surname on print outs. This can 
be  a short reminder (`Atari Dealers') or a continuation of a  long  company 
name.

Title 
Mr. Mrs. Ms. Miss. Lord, Lady if these are relevant. This an extended  entry 
field.  It will be used in a later version to allow mail merging to  include 
the `salutation'.

Family.
A  short entry where you can remind yourself of names of  partner,  children 
etc. This is another extended entry field.

                         [An  extended  entry  field is one  that  does  not 
                         appear  in every record. If there are  no  extended 
                         entry  fields  in a record then only  one  byte  is 
                         used. At present there are only two extended  entry 
                         fields. I plan to add a third to be used for adding 
                         concealed  comments  about an entry. This  will  be 
                         password protected and slightly encrypted.]

Address. 
Six  Lines  are allocated for the address. Pressing return on a  blank  line 
will take you to the seventh post code line. The post code is tagged  giving 
the possibility of a sort by post code output for mail shots.

Telephone/Data.
Although  only 3 lines are shown there is no limit to how many lines can  be 
entered. Double clicking on a line with an entry on it will highlight it. If 
you then click on another line then that entry will be removed and placed on 
the  new line (wiping any entry that was there previously). Double  clicking 
while pressing down the right mouse button will insert a blank line.

If you put ``fax'' anywhere on the line then the number will be detected  by 
the fax search facility. 

If  you have enabled the London phone number conversion facility by  loading 
LO_phone.doc  at  start  up  then any entry  beginning  ``01-NNN''  will  be 
converted to the correct ``081-NNN'' or ``071-NNN'' prefix. 

Blank  lines are ignored and are not saved so if you want a blank line  then 
enter a space.

Pressing return on a blank line will take you to:

Comment.
Again  any number of lines can be entered. Pressing return on a  blank  line 
will end the entry.


                             Executing NameNet
                             =================
Double  click on NameNet.PRG. NameNet.RSC and ADDRESS.NMN files must  be  in 
the  same folder. The program will sound the bell once as it starts to  run. 
In medium resolution colour mode NameNet will adopt its own livery of screen 
colours.  You  can stop it doing this by pressiing SHIFT until  the  opening 
bell  has  sounded. NameNet will then open a progress window where  it  will 
report  as  subsidiary  files including the resource  file  are  loaded.  It 
reports  whether GDOS is in use. This does not affect NameNet but  a  future 
option  may allow GDOS fonts to be used. A file called LO_PHONE.DOC is  then 
looked  for.  If present then the conversion table in that file  is  loaded. 
This  allows NameNet automatically to change 01- numbers into 081- and  071- 
numbers when they are entered (less of a requirement these days but could be 
useful if you are entering data from an old address book where you have  not 
updated all the numbers). 

If NameNet detects a 2016 byte file called  NameNet.COD it will load  custom 
printer  codes otherwise it will use defaults that give a choice  of  output 
for  an Epson and allow standard output for an IBM printer. The  choice  for 
the  Epson  is between small and large type, the first being for  a  Filofax 
page output. 

NameNet then closes the report window and displays a form reporting that  it 
is  loading ADDRESS.NMN. When this is complete four windows are opened.  The 
top left is where search text strings entered from the keyboard will appear. 
The  two  link windows beneath it report on any links  associated  with  the 
entry.  The entry data itself is displayed in the large window on the  right 
hand side of the screen. 

For about  a second this large window will display the start up message that 
will  be  start a file print out. It will then clear and display  the  first 
entry in the display array.  At this stage all entries will be available.

During  that  short  pause the mouse cursor will  flash  between  cross  and 
hourglass  forms.  Whenever  this happens during  the  program,  NameNet  is 
waiting  for you to press a key or to press a mouse button. When there is  a 
choice between going on or stopping a process then pressing or clicking  the 
right  button will usually stop the process. The left button  will  continue 
it.  This `keywait' state will always eventually time out; with the  opening 
screen after 1 second and in others after 10 seconds. Some keywaits are  set 
to  a very long period - 32767 seconds - and therefore are equivalent to  no 
time out.

Main Display
All  entries  are  available ``horizontally'' and can  be  found  using  the 
keyboard  or  the  mouse. Left and Right arrows move one entry  at  a  time. 
Shift/left  and shift/right arrow moves 10 entries at a time.  Control/arrow 
gives  the first or last entry. If the information in the entry is too  long 
to fit the window then the mouse can be used to scroll up or down using  the 
vertical slider. The mouse may also be used to change entries by clicking on 
the arrow or sliders and by draging the slider.

Pressing  return  always  removes any text filtering  and  all  entries  are 
available  subject to classification filtering. If classification  filtering 
is being used then a window appears listing the setting while the  filtering 
is being done.

Double clicking on the main window will give you the option of printing that 
entry. Clicking on the Up or Down link windows will allow you to examine the 
links.  If the window is only showing a message saying how many links  there 
are  then there will a pause while they are loaded. How long this  takes  is 
proportional  to  the  number of links and the length of  the  file.  Double 
clicking  on a link will clear the display array leaving you examining  only 
that link (irrespective of any classification filter settings) 

Entered  text will be shown in the top left window. When return  is  pressed 
the file is searched and only those entries that begin with the same letters 
typed  will  be  available (minus any filtered  by  classification).  Return 
pressed with no text entered will make all entries available.

The available facilities are now described in the order that they appear  on 
the  menu bar. Many of these have keyboard shortcuts that are given as  each 
facility  is described.  If there is a keyboard shortcut then this is  shown 
after the menu entry.

          Key   ALT/KEY                         CNTRL/KEY
          A     Amend
          B
          C     Change Classification
          D     Delete  Display file
          E
          F     FormFeed to printer
          G     Goto
          H     Backspace
          I     Information
          J
          K     Class Filter toggle              Set class filter
          L     Add link                         Load links
          M                                      [Return]
          N     New entry                        New 
          O
          P     Print entry                      Print file
          Q     Quit                             Remove entry
          R     Restore entry                    Review class
          S     SAVE new file                    Show class
      (Shift Save current file)
          T
          U     Utility
          V     Entry to today's date
          W     WIPE
          X
          Y
          Z

Removing Entries
You have a choice of different ways of removing entries. The first and  most 
straight  forward is DELETE. This removes the entry from the file. The  next 
is  WIPE. This removes the links associated with the entry and then  retains 
the  entry  in a separate wiped array that can be separately  examined.  The 
final  option is to CONCEAL the entry. This is functionally  identical  with 
WIPE but allows you to have a different group of removed entries. In  normal 
use  I  use  WIPE  for entries that might one  day  still  be  useful  (like 
someone's  old  address).  I use CONCEAL for entries that I  don't  want  to 
appear  on  the  screen if someone is looking over my  shoulder.  (The  mind 
boggles).  No  changes are permanent until; the file is saved to disk  as  a 
separate operation.


                                Menu Entries
                                ============
NameNet 
About NameNet
Credits Author.

Accessories 1-6
The  other  entries  are any accessories you may  have  loaded  that  remain 
available during many of NameNet's functions.

File
Load Not implemented in this version

Save                                     Shift/alt/S
The keyboard shortcut is always available. The menu entry will be greyed out 
if the file has not been changed since it was last saved.

Save as ...                              alt/S
Saves file but allows you to change its name 

New Entry                                Alt/N
See under Entry. 
The  two New Entry menu slots are functionally identical but are  duplicated 
under the File and Entry titles as New Entry is logically a file command  as 
well as an entry command.

Print File                               Control/P
Prints  file. It first brings up an alert to confirm that this is  what  you 
wanted  to do and then takes you to a dialogue where you can change  various 
parameters (see printing file).

Display File                             Control/D
Allows the file to be displayed on the screen. This can be useful to  review 
entries. (See printing file)

Long Links
If ticked then all the links are shown during a printout or file display. If 
there  is a cross beside the entry then most links are not shown except  for 
entries  with  a  key  attribute and some entries  that  have  little  other 
information associated with them.

Go to ...                                Alt/G
This takes a text input and moves you to the entry the surname/main name you 
have  entered.  If  the entry does not exist then the nearest  one  will  be 
shown. This uses the existing filtration.

Review Class                             Control/ R
This brings up the form for changing classifications. Two additional buttons 
appear  allowing  you  to move forward or backwards in  the  file.  Pressing 
SELECT changes the current entry and moves to the next. Pressing CANCEL ends 
the  Review sequence and leaves you looking at the entry you were  about  to 
change. 

Utility  Alt/U 
Various  diagnostic  tools  to check file integrity  are  placed  here.  The 
default  facility  allows  you to look at entry  headings  in  ascending  or 
descending date order.

ROGUE LINKS
This is a utility that checks the file for rogue link (links that appear  as 
``false Link'' ) and attempts to remove them. This should only be needed  in 
cases  of  file  corruption or bugs. Later versions of  NameNet  can  export 
selected  entries from the file. When the exported file is loaded there  may 
be links to entries that were not carried over. This option will clear them.

DATE FORMAT
Not  implemented in this version. This will allow American, UK  or  European 
date formats to be selected for display.

CHNG CLASSES
This  allows  you to change the names of the classification  tags.  It  also 
allows you to change the default button settings. A fairly complex  dialogue 
is   shown.  It  looks  remarkably  like  the  normal  form  for   selecting 
classifications  except  that the `buttons' can be edited  to  change  their 
contents. 

You can also reallocate the four preset buttons on the right. You can select 
any one of the four buttons. Having selected the prset button that you  wish 
to change (and perhaps changed the text inside it) you should now select the 
classes that you require to be selected by the preset. When completed  click 
on  SELECT PRESET and this setting will be remembered. 

You  can get back to your original setting by clicking on DEFAULT.  Clicking 
on  SAVE makes the present setting the default that will be saved  with  the 
file.  OK allows you to go back to NameNet with this temporary setting.  The 
main  purpose  for  this option is in later versions  that  allow  selective 
export of data. QUIT abandons changes.

LIST BY DATE
Lists entry headings in date order. You have the option of choosing  whether 
the  list  is in ascending or descending order. It can be  printed  or  just 
shown  on the screen and you can select the output to pause for a  key  each 
time the date changes.

CHECK ALPHA
This checks that all entries are in alphabetical order and correct the order 
if  they  are not. This should be needed rarely - usually only  if  a  wiped 
entry has been restored when it may rematerialise out of order. It will have 
a further use in versions that allow merging of files.

CHECK TOKENS
NameNet  identifies  each  entry  by a unique code that  is  placed  at  the 
beginning  and  end.  This will report if they are  different  due  to  file 
corruption.   It  is  able  only  to  correct  an  incorrect  header   byte. 
Nevertheless it is possible to exit the search and investigate the file with 
a  file editor such Harlekin's Monitor that allows you to change file  bytes 
while  still  running NameNet. If you exit the search the next  time  it  is 
called the search will continue from where you left. (Remember that the file 
in memory will not have been changed).

COLOUR 
In a later version the colour options will be changed using this button.

In  version 1.5 the colours used in medium resolution are fixed  (White  and 
three  shades  of  blue), When NameNet is exited  it  restores  the  colours 
prevailing when it started. 

I  am  not a heartless man and there is a facility to keep the  colours  you 
have  already set with the control panel. When starting NameNet it will  use 
the present screen colours if shift is being pressed when the bell sounds as 
it starts running. 

EXPORT 
In  later  versions this allows the export of selected  entries  to  another 
file.

IMPORT. 
In later versions this allows the merging of other files.

DO IT. Runs the selected routine. The default when NameNet is started is  to 
LIST BY DATE as this is likely to be the most used utility facility.

QUIT Don't do it.

New                                      Control/ N     
Not  implemented.  In  later versions this sets up  NameNet  with  a  single 
information entry to allow a new database file to be constructed.

QUIT                                     Alt/Q
Quit program. 
If  changes  have  been made you will be reminded and given  the  option  of 
saving the changes before exit, not saving them or resuming the program.

Entry 
New entry                                Alt/N
Brings up a dialogue box where you enter an entirely new entry (see entering 
information).

Amend entry                              Alt/A
Allows  you to change the currently shown entry but not its entry name.  The 
old  entry is automatically deleted and any links preserved.  (See  entering 
information)

Change entry                             Alt/C
This is identical with amend except that you can change the entry first name 
and  surname. After the process if you have changed either or both you  will 
be given a choice of deleting, wiping or keeping the original entry. This is 
a useful way of duplicating entries. If the old entry is kept the new  entry 
will have no links. (See entering information).

Delete entry                             Alt/D 
Delete currently shown entry. You have to confirm this twice as there is  no 
way  of recovering the lost data without reloading the old file. This  would 
lose any other changes you have made.

Wipe entry                               Alt/W 
Wiping an entry does not remove it from the file. Any links are removed  and 
then  it  is  placed is a secondary array of wiped  entries.  These  can  be 
examined  or  even recovered. This is useful for those entries that  are  no 
longer current but you might want later to look up. 

(Conceal Entry)
If  Wipe Entry is selected while pressing shift then the entry is  concealed 
rather than wiped. This is a third array that is functionally identical with 
the wiped array of entries. It can be useful to place here entries you would 
not want to appear on the screen when someone is looking over your  shoulder 
or even to whom you are showing the program.

Restore Entry                               Alt/R
This  is greyed out unless you are examining wiped or concealed entries.  It 
restores them to the main array.

Remove (temp)                            Control/ Q
It  is  sometimes convenient to be able to remove entries from  the  display 
array  temporarily so that they do not appear in a print out.  This  removes 
the currently displayed entry. Entries are restored the next time filtration 
takes place.

Show Class                               Control/ S 
Show  the classification of the current entry. A mouse click or  key  closes 
the display.

Change Class                             Control/ C
Identical with Show Class except that you can change the classification  and 
exit  by pressing return or clicking an exit button. If  the  classification 
has not been changed an alert will tell you so.

Add Link                                 Alt/L 
This is the facility that gives the program its name. You will be  presented 
with  a  form. Enter the surname that you wish to be linked to  the  current 
entry  and it will be displayed with any other entries that are  valid  (ROB 
will find ROBSON and ROBINSON for example). If the list is longer than  will 
fit in the dialogue box then you can move up and down using the buttons PREV 
or  NEXT.  Names that are longer than the space available  will  be  `folded 
under' with a right arrow symbol showing that there is a continuation.

Clicking  on  the required name will cause it to be ``down linked''  to  the 
current  entry. If you now examine the entry you have just linked  you  will 
find that it has an ``Up link'' to the calling entry. 

Double  clicking  will  add  the link straight away.  A  single  click  will 
highlight the entry that will then be linked if OK is clicked.

The defaults are unusual. When you first select ADD LINK the FIND button  is 
the  default but after the first search OK is the default. This  means  that 
normally  you can type in the name, press RETURN and then, if you  only  get 
one name found, pressing RETURN again gives you the correct linked entry. If 
the  KEEP  button is enabled then the string last entered will be  kept  and 
searched  for immediately you select ADD LINK. Simply pressing  return  will 
add  the entry to the link table. This is useful when you have just  started 
dealings  with  a  new  company and you have the names  of  several  of  its 
employees  to  add to your NameNet address list.

Any number of links may be added. They will be displayed in reverse order of 
addition (ie. the latest entry is at the top) unless they are reformatted.

Remove Links
Allows you to remove links. You are prompted one at a time whether you  want 
to remove each link. If there are both up and down links then you can choose 
only  to  edit one set or both. ALL selects both and is the  default  button 
even  if  only one set of links is available. QUIT  finishes  the  sequence. 
There  will  be a slight pause while the remaining links  are  included  and 
reformatted.

Remove  Link Not available use previous entry. remember that a link  can  be 
removed  at either up or down link end. To remove a single link;  remove  it 
from the end that has the fewest links in the list

Reformat Links
Puts links into alphabetical order. If you have a false link displayed  then 
reformat will usually remove it.

Goto Link Not available - use mouse.

Load Links                               Control/ L 
This  removes  all the other entries from the display array  and  loads  the 
links associated with the current entry. (In alphabetical order except  that 
the current entry is left first as a heading). You can load other links from 
other entries just loaded. Duplications will be removed. 

Formfeed                                 Alt/F 
Send ASCII 12 to printer (or file)

Print Info                               Alt/P
Output  current  entry to printer or file. (Or you can double click  on  the 
main information window)

Input 
From Keyboard
From File               Not available
From Modem              Not available
Programmable            Not available

Output
To Screen
Print  routine operates but does not output. Thus can be useful if you  want 
to check what items have been included or how many sheets of paper you need.

To Printer 
This is the normal option.

To File 
Clicking  on this will bring up the file selector and you will be  asked  to 
name a file for printed output to be sent to. From now on all printed output 
will  be  sent to this file until one of these options is clicked  on  again 
when  the file will be closed. You will also be given the option  of  adding 
extra  characters  to the end of the line CR/(LF). This can  be  useful  for 
importing into some word processors. Record Separator is ignored. 

To Merge File
This  by-passes  the setting of the selector and printed  output  will  only 
output first name, surname and address. This defaults to ASCII  Calligrapher 
format with the record separator being set at `~'.

To ASCII 
To 1st Word.... 
To Epson ...... 
To IBM ........ 
To Daisy wheel.. 
To Laser....... 
To GDOS........
These select output formats or printer drivers.ASCII gives ``plain vanilla'' 
output  with no codes. 1st Word gives a 1st Word style output  suitable  for 
importing  into a word processor that can be 1st Word or any word  processor 
that imports 1st Word codes. This will give emboldening of entry names.

Format
Single Column
Double Column
These options are not implemented 

Custom 1
Custom 2
Custom 3
Not implemented

Filofax 
Not  implemented.  This  is done by the appropriate  setting  of  a  printer 
driver. With an Epson printer I put it into subscript mode and set the  line 
spacing  to about half of its normal value. A future use of this will be  to 
allow the user to change the output format.

66 line sheet
Sends Page Set ASCII 66 to printer 

70 line sheet
Sends Page Set ASCII 70 to printer
An Epson printer Page Set will normally be 27+``N`` but this can be changed.

Single sheet 
labels x 1 
labels x 2 
labels x 3
Not implemented

Filters 
By Class        Alt/K
Brings  filtering  by classification into operation. If no filters  are  set 
this will take you to the class setting dialogue first.

By Attrib 
Not implemented

Set Class       Control/ K 
Sets classifications that you are filtering for. When completed NameNet goes 
into filtering mode unless no filters are set.

Set Attrib 
Not implemented

By date ... 
By text ... 
For last only 
For fax only
These options operate on the display array ``as is'' and remove entries that 
do not comply with the options set.

BY DATE 
The  dialogue allows you to set a date and select to remove entries of  that 
date,  before that date and after that date. If you set all three  you  will 
not get anything! If you want to include (or exclude) a whole month  setting 
the date to 00 (or greater than 30) will work.

BY TEXT 
Allows you to input a text string. Any entry not containing this string will 
be removed. This can be useful for looking a particular STD area code or for 
a word embedded in a remark or comment.

FOR LAST ONLY
NameNet remembers the date its file was last updated. Selecting this  option 
will remove all entries except those changed on the day of the last  session 
that   changed   data.  This  remonds  you  what  you  last   changed,   (NB 
classification changes do not change the entry date).

FOR FAX ONLY
This looks for the string `fax' in the telephone entries (case independent).

Telephone 
Fax line 
Address 
Remarks 
Comments 
Up refs 
Down refs 
Title 
Spouse 
Selector ...
These  options program what fields are output when the file is printed  (see 
printing file). Ticked options will be output. Clicking on the entry toggles 
the output. Clicking on Selector will give you a dialogue box that is easier 
to  use  if many options need to be changed. There is an  additional  option 
that  allows you to choose whether entry names should be ignored totally  if 
all their information has been stripped.

There is no option to print the entry date stamp as this is only useful  for 
maintaining the data. The list dates option in the utility option allows you 
to print out entry headings by date.

Set
Custom 1,2,3.
Custom A,B,C.
Not implemented, What do the ``customers'' want?

Epson (filo) 
Epson (A4) 
IBM 
Laser......... 
GDOS .......
These  options  allow you to program the printer drivers.  The  names   will 
usually be changed to something else by the driver configuration. 

The default drivers will cover many eventualities but otherwise click on the 
driver  that  you  wish to change and a dialogue form  will  appear  listing 
various printer code options like underline and bold. Page Set should be set 
to the code that sets the page length for your printer. Print set is what is 
sent  to  the  printer at the start of print out or when  a  new  driver  is 
chosen.  The codes should be entered directly using the control  keys  where 
necessary. (ASCII 1 ... 26 are control a to z. Escape is control/[). ASCII 0 
usually  cannot be input form the keyboard  so if you need this (often  used 
in Epson Off codes) then enter it as `0' including the single quotes.  Users 
of some utilities like the Harlekin accessory will be able directly to input 
ASCII  codes  by  keying in the decimal code on  the  numeric  keypad  while 
pressing ALT. 

The NAMENET.COD file format has been chosen to allow it easily to be changed 
using a file editor such as Harlekin's monitor. This can be easier if a very 
complicated  sequence  has  to be programmed. Each  variable  has  48  bytes 
allocated  to it. The easiest way of using this method is to use NameNet  to 
save an easily recognisable dummy code - like a string of Z's and then  edit 
the resulting file.

Laser and GDOS are not yet available. 

Modem 
Not available 

Start Message 
Allows  you to set the message that is printed at the start of a file  print 
out.  This message is shown briefly when NameNet is first run. Its main  use 
is  for putting your own name and address at the front (eg. If found  return 
to ...).

Page message
Not available but will allow you to set headers and footers on the printout.

Help 
Version 1.5XX 
This will show the version number. Clicking on this will produce details  of 
how to register and obtain the latest version.

dd/mm/yy. 
This will show the current date as set on the Atari's clock. It is  intended 
that clicking on this will allow you to set the date in a future version.  I 
have  not  given  this priority as most people will either  have  a  battery 
backed clock or a  control panel accessory.

HH:MM
This  will show the current time. It is intended that clicking on this  will 
allow you to set the time in a future version.

Memory 
This  shows  the remaining memory available in the  different  HiSoft  Basic 
classifications.

Sound FX OFF 
Toggles  whether sounds are emitted by the program. When they  are  switched 
off this is shown as `Sound FX On'.

Statistics                               Alt/I
Collects and shows the statistics for the file. 

Help!!!                                  Help.
This  or  HELP key gives some context sensitive help although this  is  very 
rudimentary at present.

Show Keys
Shows the major keyboard shortcuts 

Wiped entries 
Clicking  on  this will scroll the wiped entries down the screen.  You  will 
then  be given the option of examining the wiped entries. If you decide  yes 
then the main display array becomes the wiped entries. This slot will become 
ticked.  Clicking it again will take you back to the choice of what to  look 
at.

CONCEALED ENTRIES
If you press shift while clicking this then you will be given the choice  to 
look at concealed entries. They are not scrolled down the screen first!  The 
ticked menu entry becomes ``CONCEALED''.


                            Entering Information
                            ====================
You  are presented with a form. The flashing cursor will be at the top  left 
field  `First name' unless you are amending an entry. In this case  you  are 
not allowed to change the first name or surname and they will be greyed out. 
Instead the cursor will be on the Remark field. Pressing TAB, RETURN or down 
arrow will take you to the next field. You will not be allowed to leave  the 
surname field blank. 

As  a formatting aid, the first letter of each word is usually forced to  be 
uppercase. There are three icons in the box in the bottom left hand  corner. 
The  up  arrow icon indicates that each word will be capitalised.  The  left 
arrow icon indicates that the first letter in the line will be  capitalised. 
The remaining o icon shows the setting of the shift lock button.

In  the  same box are the attribute buttons. When starting a new  entry  the 
NameNet icon will be shown on the form. You cannot complete an entry without 
selecting  one  of the buttons. If you try to leave the dialogue  they  will 
flash  in an annoyed fashion to remind you. (Exiting by clicking CANCEL  is, 
of course quite possible). Apart from changing the icon little else is  done 
with this in this version.

The address is entered  quite normally except that exiting a blank line will 
take you straight to the post code line.

The  telephone  entry is straight forward. The entries scroll if  you  press 
return  on a non-blank third line. A single click while pressing  the  right 
mouse button will scroll three lines at a time. The up and down arrows  will 
scroll  one  line at a time. Double clicking them takes you to  the  top  or 
bottom  of  the  list. As indicated by the changed of highlit  title  it  is 
intended  that  data  entries (credit card numbers and  the  like)  will  be 
entered  here when the data attribute is used. On the screen and  print  out 
neither name is used. 

Double  clicking on a line with the right mouse button down inserts a  blank 
line.  If you wish it to remain blank in the saved version you must  put  at 
least one space on the line. 

Double  clicking  on an entry will highlight it. When you  single  click  on 
another entry the entry will be moved. If, when you are reordering material, 
you have blank lines then remember that they will be removed as part of  the 
saving process. There is no programmed limit to the number of lines that can 
be entered.

COMMENT  Entry  is  very similar to the telephone.  Additionally  it  has  a 
vertical bar that operates like a simplified window slider although dragging 
is  not  supported.  Clicking  above the slider takes you  up  4  lines  and 
clicking  below takes you down 4 lines. The slider will never quite  get  to 
the  bottom as you add entries because now and then NameNet  allocates  more 
memory for the comment. There is no programmed limit to the number of  lines 
that can be entered.

Printing File
Control/P  or  clicking on the `Print file' menu entry  will  cause  NameNet 
first to ask you to confirm that this is what you want to do. If you say yes 
then  you  are  taken  to a dialogue form that shows  the  defaults  in  the 
selected  driver  and allows you to choose some printing  options.  It  will 
briefly  flash a warning if the array has been filtered. It will  also  show 
the text string used to filter the file if any. 

There is an editable box allowing you to decide the start from page and  the 
end at page setting. This setting is only used if the page select ON  button 
is  selected.  NameNet  will still format from page one but  only  turn  the 
printer on (or output to file) between those pages.

PROMPT AT END OF PAGE. If this is selected then an alert is shown after each 
page and you have to click or press return. This allows single sheets to  be 
used.

LINES PER PAGE. You can change this setting. It defaults to whatever is  set 
in the printer driver.

ODD PAGES ONLY
EVEN PAGES ONLY
SHOW ALL PAGES These button allow you to set up for double sided printing.

FORMFEED If selected there will be a form feed after each page.

LINEFEED If selected, there will be a line feed after a Carriage return.

QUIT Your next chance not to print the file.

OK Let's do it.
Once printing has been agreed then the normal screen windows are closed  and 
are replaced by three windows.

The  top  left window headed PRINTING FILE reminds you that  you  can  abort 
printing  with control/a or by keeping the right mouse button pressed  down. 
It shows the text selection used.

The  bottom  left window shows the progress of the printout by  listing  the 
Name fields. Each entry's first and surname is displayed. If you have  asked 
only for parts of the entry to be printed (say telephone numbers only)  then 
those entries that contain no information in the required fields will not be 
printed and will be shown greyed. (You can force all names to be printed  by 
using the selector option under the MENU Filters heading). 

The  right  hand window shows the page being printed or omitted.  Until  the 
first  page is printed there is a fourth window shown on top of this  window 
that shows the filtering settings.

                                  History
                                  =======
Way  back  when I only had a UK101 computer I needed  something  that  would 
order  my  address book. As the machine only had a  cassette  interface  for 
storage, 8K of memory and no file handling it was unambitious and worked  by 
modifying its own data statements and then resaving itself onto cassette. 

The idea was that now and then I would print out onto `Filofax' style sheets 
to  have  something to carry around. That version had the provision  for  15 
tags etc? This was ported to a BBC Micro and because of the availability  of 
a  disk  drive  was able to be come more ambitious  (it  actually  had  file 
handling!)  and  became more than a printer driver allowing  more  on-screen 
manipulation of the data. 

I then bought an Atari ST and decided fully to exploit its memory  capacity. 
It  was now that the networking facility of linking entries  was  introduced 
and the program was given a name - NameNet. 

This program has `Topsied' - that is `It just growed'. Every time I needed a 
facility  I  added it. This process still continues. I am  offering  NameNet 
rather  diffidently  onto  the unsuspecting public as they  may  be  totally 
underwhelmed.  On the other hand if there is sufficient interest then I  can 
add facilities that other people want and have something even more useful.

                                                      Roger Derry April 1991


