@DATABASE Barney.guide

@AUTHOR "Jürgen Schmitz"
@(c) "(c) 1994 by J.Schmitz, by GuideGen"
@$VER: Barney.guide 1.0 (25.07.1994)

@REMARK Made by GuideGen 0.85 (31.07.94) Unreg.

@NODE main Barney.doc
@TOC MAIN
@NEXT Required
@PREV main

                               @{I}@{B} Barney @{UI}@{UB}

                   the new filelist request utility
                             (Shareware)

                             Version 1.04


   Well, this is only a short documentation for Barney. I think most
of the freatures explain themself. Some don't.


  @{"   Required                 " LINK Required}        @{"   Tooltypes / WB start     " LINK Tooltypes}
  @{"   Freatures                " LINK Freatures}        @{"   CLI start                " LINK CLI_start}
  @{"   Install                  " LINK Install}        @{"   Some internals           " LINK Some_internals}

  @{"   Generals                 " LINK Generals}        @{"   Something brand new      " LINK Something_brand_new}
  @{"   Start                    " LINK Start}        @{"   How to register          " LINK How_to_register}
  @{"   Preferences              " LINK Preferences}        @{"   The Author, Copyright    " LINK The_Author__Copyright}

  @{"   Phonebook                " LINK Phonebook}        @{"   Addresses                " LINK Addresses}
  @{"   Unpacker window          " LINK Unpacker_window}        @{"   Versions of Barney       " LINK Versions_of_Barney}
  @{"   Phone number window      " LINK Phone_number_window}        @{"   Thanks & some words      " LINK Thankssome_words}

  @{"   Extras window            " LINK Extras_window}        @{"   Problems? Some tips...   " LINK Problems}
  @{"   Main window              " LINK Main_window}        @{"   I found a bug - and now? " LINK BugFound/main}
  @{"   Search                   " LINK Search}        @{"   SOMETING SPECIAL!        " LINK Advertising}
@ENDNODE
@NODE Required Required
@TOC MAIN
@PREV main

** Required **

 * OS2.0 or better
 * for locale support OS2.1 or better
 * for memory pools, new look menus OS3.0 or better
 * AMIGA computer!
@ENDNODE
@NODE Freatures Freatures
@TOC MAIN

** Freatures **

 - automatic detection of unpacked filelist names
 - calculates time and costs of request
 - call node from Barney
 - can handle PC-DOS filenames in list (8.3-names)
 - copy new filelists from INBOUND direct to any wanted directory
 - english catalog
 - enter own phone number without nodelist
 - filelist can have any wanted name (!)
 - full control by keys
 - full OS2.0-GUI (AUISG: screenmode, 3D-gadgets, colours, etc.)
 - handles every fileformat by free editable pattern
 - handles US-date (month then day)
 - locale price calculation 
 - manual input
 - OS3.0 freatures (screen title, 16.8 mio colours, ...)
 - OS3.0 memory pools
 - password file request (enter password after selection in list)
 - ready for NodelistViewer 1.3 External-Program-Port (!)
 - reqtools.library support (may selected by user!)
 - reroute requests to other nodes
 - search for names, files, dates, new files
 - search function uses AmiagDOS patterns
 - Shows the list in a (own) listview
 - traplist.library support
 - unpacks packed filelists before listing
 - uses js_tools.library for listviews and other things
 - visual feedback

 and much more
@ENDNODE
@NODE Install Install
@TOC MAIN

** Install **

   If  you are using OS2.0 then start the "Install_2.0" script. If you
have  OS2.1  or  better  and/or  the  commodore  installer (in your C:
drawer!  You can find it on the install disk) start the install script
in  the  "Install_2.1+"  drawer. If you have "only" OS2.0 but also the
commodore  installer  you  can  install with the install script in the
"Install_2.1+" drawer, too!!
@ENDNODE
@NODE Generals Generals
@TOC MAIN

** Generals **

   All  functions  in  Barney  have keyboard shortcuts. Simple buttons
will  be  shown  pressed  if  you  press  its  key.  To abort keyboard
selection  simply  press  CTRL  key  before  you release the key. Text
fields  may  be  activated  by  pressing its key, the requester button
behind  (e.g.  for file requester) could be pressed with SHIFT and the
same  key.  The  first  unlocked  string  gadget of each window may be
activated with the TAB key.

   You  may  choose  a  gadget  when  you  are in a string gadget with
pressing  the  RIGHT  AMIGA key together with its shortcut. This works
only in an active string gadget otherwise a pulldown menu item will be
selected  (if  there is one)! Pressing the shortcut of a string gadget
with  RIGHT_AMIGA  while  one is active will have the same effect like
pressing  it  together with SHIFT if no string gadget is active (OK? -
test  it!).  If  you want to abort in string gadgets with CTRL key you
must release CTRL as last key.

   All  others  gadgets  react  at  once  if you press the marked key.
ATTENTION!  Reqtools  requesters  use  the SHIFT key to abort keyboard
selections  (why  Nico?).  I use the CTRL key because SHIFT stands for
"alternative  selecting"  like  cycle back, move slider the other way,
jump in a list. CTRL gives you the ConTRoL to stop something....

   Barney   also  supports  "traplist.library"  to  search  names  and
phonenumbers of nodes - if you want!
@ENDNODE
@NODE Start Start
@TOC MAIN

** Start **

   You  can  start  Barney  from Workbench or from CLI (with a minimum
stack  size  of  8000 bytes). When you start Barney for the first time
the  preferences window will be opened on the workbench because Barney
needs some start information.

@{" PREFERENCES " LINK Preferences}
@ENDNODE
@NODE Preferences Preferences
@TOC MAIN

** Preferences **

   Please  enter  the  paths to your filelists, where to unpack packed
filelists, your outbound and your nodelist (traplist compiled - if you
have  non  leave this field empty). If you want to call the nodes from
Barney  you  will also have to enter the path and name of your calling
programm  (TrapDoor,  etc.)  and  in  the  parameter  line  the needed
parameters  ("CALL  %N",  etc. like shown). For more details press the
"?"-gadget  ("info  gadget").  You may open all the file requesters by
pressing the underlined key and SHIFT together. Without SHIFT you will
get  into the string gadget (you remember? That's everywhere in Barney
handled this way!).

   To   change  screenmode,  screenfont  and  colours  (not  at  FIRST
startup!)  select  the GUI button for GUI window. The fixed width font
is  used  e.g.  in the phonebook nodeslist (you will understand if you
have finished setup). Some used colours may also changed here.

   Then  you  can  change  the requester-library you want to use. This
opens  a new window and you may switch between Amiga library functions
(like  ASL  library  or  intuition) and other libraries, like Reqtools
(witch is the only one in this release).

   Now  enter  a Default address which will be marked in the phonebook
every time you start Barney.

   The  next  3  entrys  are for the cost calculation. The two default
settings  will  be shown in the phonebook if you enter a new node (but
you  may  change  them there again). The last one is the price itself.
Please  enter  it  in  the smallest unit of you country (e.g. Pfennig,
Groschen, Cent, Pence, etc.).

   Next you have 4 on/off switches. "Read phone numbers" will show you
the phone number of a selected node in the phonebook (traplist.library
required).  "Read at startup time" will read this numbers if you start
Barney.   Generally  Barney  don't  save  the  phone  number  in  it's
phonebook! So it has to read this every time is meets a new node (then
is  is  stored  until  you  leave  Barney). Warning! Reading all phone
numbers at startup time may take a long time!

   Well,  the  next  of this 4: Barney saves for each request 2 files.
One is the real request for you call programm (.REQ-file) and one that
contains  some additional information (like the file size - .BX-file).
If  you  call a node the .REQ-file will be deleted by your caller, not
the .BX-file. This .BX-files could be deleted when you leave Barney by
the  switch  "del  .BX-files  automaticly".  (You may also delete this
files by hand via menu in the main window or phonebook!)

   The  "BX/REQ  flags"  are  shown  in phonebook if you turn the last
switch  on.  They  show you if you have file requests or not. But this
checking every time you go to the phonebook needs its time!

   If you start Barney for the first time please SAVE your settings or
you will have to do this again the next time you start Barney.


   Now  you  see  the main screen and the @{"phonebook" LINK Phonebook}, which is empty at
your first start. So you have to add a "NEW" node (see below).
@ENDNODE
@NODE Phonebook Phonebook
@TOC MAIN

** Phonebook **

   In  the  upper  part  you  see  a list of your phonebook, the nodes
Barney  knows.  You may edit them, delete them, call them or see their
filelist  (that's  what Barney is for!). If the showing of the "BX/REQ
flags"  is  turned  on  you'll see (or not!) a "B" or a "R" behind the
nodes.  "B"  means there a .BX file, "R" if a .REQ file is present (if
not you see a "-").


Some things you should know about the items:

Address     - Fido (& komp.) address
Name        - name of the system
Phone       - shows phone number - button behind opens @{"phone number" LINK Phone_number_window}
              window
ø CPS       - the CPS you think you might get
              (used for pirce calculating)
Unit length - length of one phone unit
Listname    - name of the (packed) filelist (always the path set in
              the prefs!)
              (don't forget the SHIFT-Key to open the file requester
AKA         - Well, if your node has more than one phone line he might
              have diffrent node numbers. So you can enter more than
              one address for him in Barney. But to have only one
              request list simply enter in this field the number the
              request list should have.
              Example:
               My boss has the numbers 2:2454/550 and 2:2454/551.
               I have both in the phonebook with the same settings but
               different phone numbers. The AKA-field of /550 is
               empty but in the one of /551 stands 2:2454/550.
DOS-name    - Some systems have filelists in the PC-DOS format.
              That means always 8 letters (filled up with spaces), a
              point and again 3 letters. Well, Barney interpretes a
              space as the end of a file name and the start of the
              size. So it couldn't handle this 8.3s without switching
              this on.
US-date     - The US-date is in 1 way different from the european one:
              day and month are changed. Turn this on and Barney has
              no trouble with this (it is needed for parsing a line
              and searching for dates).
Menu        - If you want to load the list of this node simple by pull
              down menu from the main window, turn this on.

Unpacker    - opens the "@{"Unpacker" LINK Unpacker_window}" window

Extras      - opens the "@{"Extras" LINK Extras_window}" window

OK          - goes to @{"MAIN window" LINK Main_window}


   If  you  have  changed  a  phonebook entry (also by unpacker, phone
number or extra window) it will be updated at once (new since V1.02).

   That's  all you must know, the rest explain themself. Well, if not,
here  some  more infos: "NEW" adds a new empty node entry to the list.
"UNDO"  resets to the unchanged entry (only until you move to an other
entry), "DUPLICATE" makes a full copy of the current entry.

   Some  string  gadgets  have no keyboard shortcut because there were
not  enough letters left (currently only english locale!). But you may
activate them by moving in the gadgets by pressing the TAB key.

   If  you  move around with the cursor up/down keys the gadgets below
won't  be  changed until you leave the cursor key. This is for quicker
scrolling.

   The pulldown menus present some more freatures. You may load an old
saved  phonebook  back  if  you  have  changed something, you may show
Barney  info or leave program. For the current (selected) node you can
add  a  FILES  request  or copy the filelist from INBOUND directory to
your  filelist  directory  (e.g. if you have just called this node and
got  a new filelist). You may also check all .BX-files (see @{"PREFS" LINK Preferences}) and
delete  unused.  Finally  you  can  open the prefs editor (without the
posibility to change any screen prefs!).
@ENDNODE
@NODE Phone_number_window "Phone number window"
@TOC MAIN

** Phone number window **

   Well,  here you can enter a phone number for the node (e.g. if node
not  present  in  nodelist,  you  have  no nodelist or this node has a
second  phone  number).  The "info button" shows/sets the phone number
that is set in the nodelist.
@ENDNODE
@NODE Unpacker_window "Unpacker window"
@TOC MAIN

** Unpacker window **

   Here  you  can  turn  on  and  off the automatic unpack function of
Barney. You may enter the unpack program ("LhA e %n"). "%n" stands for
the  position of the unpacked filelist. In the last string field enter
the name of the unpacked filelist (always the path set in the prefs!).
Barney  may look for the needed unpacker and the name for the unpacked
list  "auto"maticaly.  The  unpacker  is  currently  recognized by the
filename  suffix.  If  more  than one filelist is available for a node
(e.g. some systems have also a NEWFILES list included - "why?") Barney
opens  a filerequester where YOU must choose the correct list. ".info"
and ".guide" files are ignored!

   This unpackers and suffixes are currently supported by automatic:

 LhA    (".LHA", ".LZH")
 UNARJ  (".ARJ")
 UNZIP  (".ZIP")

All other unpackers(!) must be entered by hand.
@ENDNODE
@NODE Extras_window "Extras window"
@TOC MAIN

** Extras window **

   For  more extra switches and configs (only in @{"registered version" LINK How_to_register}!).
You  can  set the font for this node/filelist: IBM-PC (Barney.font) or
AMIGA (topaz.font). Now you can enter the letter(s) that allows Barney
to find an area start (e.g. most lists use a graphic border around the
area  name and you simply enter the edge of the first line, other have
something like "Area" or "*** Area"). Because the IBM-PC font has some
graphic  letters and you can't find them on AMIGA keyboard you can see
them  in  the list at the right and add the selected on to the string.
ATTENTION!  Barney's  area  jump  is  case  sensitiv! So "Area" is not
"AREA"  or  "area"  AND  "Area" is not "Area " (see last space!). Some
filelists  don't support this freature - so, tell YOUR SYSOP to change
this, there's no other way.

   Then  you  may  edit  the  pattern  for  parsing  a  line so Barney
recognizes  a  file  and the size. The filename is always the first so
you must/need not enter a pattern for this. But all the next parts you
may  select:  "S"  stands  for  filesize in bytes, "K" for the size in
kbytes,  "D"  for  the  date  (US  or europeen format). "X" is a dummy
pattern  for  nothing (to ignore some texts). For more details look in
the @{"Barney Internals" LINK Some_internals} discription. ATTENTION! You must enter one of the
size patterns! If you enter no date pattern (maybe a list has no date)
you can't use the date functions in search window!

   Below  is  a  field  for  your  default password. This password (if
entered)  is  always used if you select a file. This has nothing to do
with  your  session  password  in your mailer! (look also the @{"problems" LINK Problems}
chapter for session password)

   Well,  some  filelists  are  long, really long, too long to load it
completely  into  RAM.  If  you  have such a list, activate the "PART"
switch. Finally you must set the size of each part (in KB). Now BARNEY
only  loads  a part of the filelist with the set size into memory. You
may  go  to next parts and back in main window. The size must be equal
of bigger than 100 KB!
@ENDNODE
@NODE Main_window "Main window"
@TOC MAIN

** Main window **

   At the bottom there are all gadgets you need to go to the different
parts of Barney:

 the @{"phonebook" LINK Phonebook},
 the @{"preferences" LINK Preferences},
 the manual input,
 the @{"search  window" LINK Search},
 to call,
 to save the request,
 quit program

 and switch to the request list and back.

   With the "+" and "-" button you may jump to the next/prev area of
the list (see @{"extras window" LINK Extras_window}). (only in registered version!)

   If the current list is displayed in "PART" mode (see @{"Extras window" LINK Extras_window})
there are 3 more gadgets available to go the the next, before or first
part.

   The  pull  down  menus have some more functions like iconify, clear
the  request  list  and request a new filelist (that simply enters the
magic  "files"  to  your  request). You can also add the request of an
other  node  to the shown node (this opens a special phonebook). (only
available in registered version!)

   I "PART" mode you may jump to all already shown list parts with the
part pulldown menu (for more details look in @{"internal descriptions" LINK Some_internals}).

   Beside the underlined key you can use this ones:
   
 CURSOR UP/DOWN: move the select line in the files list 1 up/down
     with SHIFT: jump 1 page up/down
       with ALT: jump to the first/last line of the hole list
       
 RETURN in "FILES" list:   add this file to the request list
        in "REQUEST" list: open the manual window with the selected
         file included (for changing/adding password)
         
 CURSOR LEFT/RIGHT in "FILES" list:   jump to last/next area        
                   in "REQUEST" list: nothing

 SPACE in "REQUEST" list: mark/unmark selected file,
                          marking may be breaked with CTRL key

   In REQUEST list you may select more than one line with MULTISELECT:
pressing  SHIFT  together  with mousebutton or only with SPACE key. If
any  line  is multiselected REMOVE and MANUEL buttons have a different
meaning.  REMOVE  will remove all selected lines, MANUEL will open the
manual window for each selected file.
@ENDNODE
@NODE Search Search
@TOC MAIN

** Search **

   For search all known (and unknown) AmigaDOS patterns are supported.
You  may  search for a text (word, etc.) in the whole list, only for a
file  in  the  files part, for files that are younger or older than an
entered  date or for the newest file (but this is not supported by all
filelists  -  there  must  be  a star after the date to indicate a new
file). 

   The  three switches in the right will turn on the automatic search,
that  means  all  found  files will be put to the request list. If you
don't  want  to  see  them  while  searching turn the switch below off
(quicker).  (only  available  in registered version!) In PART mode the
"MORE  PARTS"  switch tells BARNEY to continue search in the following
filelist parts.

   Now  you  can  start  searching  - at the top of the list or at the
current position of the cursor (= highlighted line).


   Searching  will  open a new window. If something is found you might
choose what to do with it (Cont search or put it to request list if it
is  a  file).  "Mark  the  file"  will  put the last found file to the
request  list  if  the  found  line  contains  no  file.  You can stop
searching  by  pressing the STOP gadget (if BARNEY loads a new part of
the filelist you must wait until it is completely loaded).
@ENDNODE
@NODE Tooltypes Tooltypes
@TOC MAIN

** Tooltypes **

   Barney has a few tooltypes which set general preferences for expert
users. Add them to activate.

@{B}NONEWLOOK@{UB}  will  turn  off the new OS2 look of all Barney proportional
gadgets.

@{B}NOREQTOOLS @{UB}won't open reqtools.library for use.

@{B}NOTRAPLIST@{UB}  won't  open  traplist.library for use (i.e. Barney doesn't
look for bbs names and phonenumbers itself).

@{B}NOONSHOWN@{UB}  turns  off  a  special freature for MOUSE&KEY users. If you
scroll  through the filelist by mouse and then press cursor up or down
the  first  or last entry of the shown list page will be selected - if
this  is  turned off (= TOOLTYPE added) the list will jump back to the
last selected line (like before).

@{B}LISTMATCHOFF@{UB}  will  turn  off the function to manipulate the phonebook
window  to  open  with the correct width for the phonebook listview if
you  use  a smaller font for the rest than in the listview (so you see
the R/B flags).
@ENDNODE
@NODE CLI_start "CLI start"
@TOC MAIN

** CLI start **

   All  @{"tooltypes" LINK Tooltypes}  switches  are also supported in CLI start. You have
also  the  keyword  "ADDRESS".  This allows you to start BARNEY direct
showing  the  filelist  of  this  node  which has to be already in the
phonebook! (e.g. "BARNEY address 2:2454/550")
@ENDNODE
@NODE Some_internals "Some internals"
@TOC MAIN

** Some internals **

   Per default Barney needs a special filelist format to see a line as
a file:

<Filename>SPACE(s)<Size>SPACE(s)<Date + star for new file>

Or if DOS-names is aktiv:

<Filename always 8 letters>.<3 letters>SPACE(s).... like the other

The size can look like this:

 100000 (only numbers)
 10.000 (with seperator)
 10,000 ("    "        )
    10k (k for kilo)
     5M (M for mega)

The date can look like this:

 01<something>01<something>94
  1<something>01<something>94
  1<something>Jan<something>94
 01<something>Dec<something>93 
 01<something>Dez<something>93  (german month!)
 11<something>26<something>93   (if US-date is ON)
 01<something>12<something>1993 (year with 4 letters)
 01<something>12<something>93*  (star (*) marks new files)

   Since  Version 1.02 you can edit the lineformat. Filename is always
the  first  and  you  can't  change  this  (this  is  because  of  the
DOS-names). To understand the patterns examples are the easiest way:

 Pattern  line in filelist

  SD     <Filename>SPACE(s)<Size>SPACE(s)<Date>
  XSD    <Filename>SPACE(s)<something, not for Barney>SPACE(s)<size...
  DXS    <Filename>SPACE(s)<Date>SPACE(s)<something>SPACE(s)<size...
  KD     <Filename>SPACE(s)<Size in kbytes>SPACE(s)<Date>


   Barney  works  if  you  are  not  working! To increase search speed
Barney scans the list a second time after loading. This scan looks for
all filedates, sizes and names and writes them in a special list. This
scan starts if you do nothing for 1 secord or so (but only in MAIN and
SEARCH  window!).  If  you  start  searching  at once after loading or
before  scanning  has finished the old searching principe will be used
for  the lines that were not scanned. But all lines that were searched
in  are scanned at the same time. So if you search the second time, it
is  much  faster (and with faster I mean faster!). ATTENTION: This new
freature needs 10 byte more for every line!

   Some words about the PART mode. As you have seen you can only go to
a part that has been already shown or one part behind the last shown.
This has a simple reason: Every part should have a full text line at the
end. But if you simple devide a list in parts of e.g. 500 KB you may
have on half of the line in one the rest in the other part. So BARNEY
puts the first half to the "other part". But how should BARNEY know,
where this will be e.g. 4 parts away. ATTENTION! For now BARNEY only
supports 20 parts. But this seams to be enough (if you have a 2 MB
list you may make each part 100 KB big - or better small). 
@ENDNODE
@NODE Something_brand_new "Something brand new"
@TOC MAIN

** Something brand new **

   If Barney opens his phonebook a "NLV-external-program" message port
will  be  opened.  This  is a freature of the brand new NodelistViewer
(NLV)  version  1.3  (currently in beta-testing 20.02.94). This allows
you  to send nodes from the NLV direkt to Barney without this peace of
paper  or  this screen switching for many times. Simply press 1 button
in NLV.

   If  you want to know more about this (NLV 1.3 or this message port)
write  to  the  author.  I hope many programs will follow this way and
have  a NLV message port (for programmers info ask the author). If you
want to have NLV - frequest "NLV.LHA" at 2:2454/550 (or 39:176/401).
@ENDNODE
@NODE How_to_register "How to register"
@TOC MAIN

** How to register **

   Barney  is  shareware!  The  registration  key  costs 30 DM (German
Marks).  Please  use program "REGISTER" to print out the register-form
and  send  it  to  the  authors address (shown in the form) by post or
Fido/AmigaNet  private  netmail.  You  will  get  your  key as soon as
possible! You can find all important infos on the form. If you want to
get your key by disk, maybe you'll have to wait a few days more for it
(Fastest  way  is File-Attach or put on Hold) and you have to pay 2 DM
more  for  it!  This  key  will disable the "shareware requesters" and
unlock  some  freatures.  You  MUST  NOT  give  your key file to other
persons!
@ENDNODE
@NODE The_Author__Copyright "The Author, Copyright"
@TOC MAIN

** The Author, Copyright **

       Barney was written in KICK-Pascal 2.1 by MAXON-Computer.

The source code of Barney is copyright © 02/1994 by J.Schmitz [SOFT].
         Barney is published under the concept of SHAREWARE.

   Barney  may  be  put on PD disks or sent via electronic way. If you
put  it  on  a  PD series disk send a copy of this disk to the author,
that's all you must do.

The  AmigaGuide  Doc  was  made  with  SuperPrint's  .sprint  file and
GuideGen by J.Schmitz.
@ENDNODE
@NODE Addresses Addresses
@TOC MAIN

** Addresses **
                            Jürgen Schmitz
                             Bergstr. 82

                            D-56859 Bullay
                               Germany

FidoNet:
                    Juergen Schmitz @ 2:2454/550.3

AmigaNet:
                    Juergen Schmitz @ 39:176/401.2

Internet:
                  j.schmitz@rheinland.sky.oopsnet.de


Please add the version you are using if you write me.
@ENDNODE
@NODE Thankssome_words "Thanks & some words"
@TOC MAIN

** Thanks & some words **

   Barney  was  developed  because there was no AUISG filelist viewer.
And  I like to have my screenmode, my colours and my 3D gadgets. Well,
and  sometimes  I  don't  like  to  work with the mouse but most AMIGA
programs can only be controlled by mouse.

   It's time to thank all the people that tested Barney (pre-releases)
on  their  systems.  Thanks  for your ideas (some of them were already
present  in  my  brain but you told me to realize them ;-). Well, some
guys asked me to write a german doc. Well, I always wrote a german doc
in other programs and let them translate to english. This time I wrote
the  english  doc - I know me: If I write a german doc I will talk and
talk and talk.... ;-)

   Really  some people don't like Barney. Well, some people don't like
AMIGA,  others  don't  like  driving or going by car. You need not use
Barney but if you do enjoy it.

  Seems  some  guys have really unknown filelists that Barney couldn't
handle  before  1.02. I hope it does now. If not or you don't know how
to  configure Barney for you filelist, well, if you don't write me and
send parts of them, how should I know of them??

  Wow,  a new step in perfectivity. Barney is font sensitiv and I hope
the  phonebook  will  work with the two different fonts. On OS3.0+ MX-
and CHECKBOX- gadgets are scaled.

   Well,  last  weeks where some hard discussions in AMIPROG.GER about
visual  feedback  of  gadgets  and  problems  with  later  releases of
AMIGA-OS  (so  it will be). I can tell you this: My feedback will make
no trouble! It uses good old INTUITON for this!

   
A few words about Barney and some functions:

   Some  guys  aked me to add the possibility to enter the phonenumber
by  hand. This was very hard because the concept of Barney was to make
full  use of the nodelist and there were this 2 buttons in the prefs I
don't want to remove... So I realized this way and it is very good!

   The people that want to enter the number may do this - the others
needn't. Well, if now a node gets a new phonenumber the guys without a
nodelist must change this anyway and the others needn't because Barney
does this for them ("ah, I'm soooo good... ;-))"). 

   Before  anybody  askes  me  why  I  take this way of using REQTOOLS
(nobody  does  until  now)  -  why  not?  Some  people  like  REQTOOLS
filerequester,  others  don't; some people don't like to use the mouse
to "answer" a simple requester, other don't.

   Why  is  the name of Barney "Barney"? Hm, why not? Most people know
and  like  the  Flintstones ("Familie Feuerstein") ;-) And Barney is a
funny  and  intelligent  guy.  So  Barney  is  a program with Barney's
"HEHEHE" and "HOHOHO" and of course Yaba dabba doo.....

   What  for  is  this button "show this marked"? Well, my listview is
quick  -  quick  in  finding  a line and scrolling. But printing every
found  line and then mark it is very hard - there isn't much to scroll
because  most  times  there  is  more  than one page between two found
items. So the listview has to print all lines - and filelist lines are
really full lines. So on a DBLNTSC-Screen with about 40 lines (or more
on a graphics card) this needs its time.

   No  bug - a freature! If you scroll in the fileslist by selecting a
line  and  moving  the  mouse  to  the  top or bottom you may speed up
scrolling by slowly moving the mouse left or right.

   The best size of filelist parts depends on your system. With "only"
1  MB  make  it  about  300-400  KB, with about 2 MB or more set it to
600-800 KB. But better you test the best settings!

   You  can  always  get  the  newst  release of Barney at 2:2454/550.
Frequest  for "BARNEY.LHA". Small bug fixes and beta releases are only
here published!


Ah, forgotten:

   As  always  there is a .SPRINT file for this doc to help SuperPrint
to make a wonderfull printout of this text.

   SuperPrint is a free program of J.Schmitz [SOFT] and supports since
version  3.0  generating TableOfContext. Request for "SPRINT.LHA" (now
font sensitiv!!).
@ENDNODE
@NODE Problems "Problems? Some tips..."
@TOC MAIN

** Problems? Some tips... **

   Well,  there  were much questions of users when they use BARNEY, so
here   are   some  of  the  most  ones  and  the  answers.  I  use  as
default-mailer  TRAPDOOR  but  I  thing  most others work the same way
(TrapDoor - Mailer, TrapList - Nodelist compiler).


@{I}Q: Every time I want to load a filelist BARNEY crashes after a second.@{UI}
A: Well, this was a problem of versions before 1.01b. If you enter a
   CPS and/or unit length of 0 (zero) BARNEY made a division by zero
   and crashed. Now fixed.

@{I}Q: I have no NODELIST installed but I want to use BARNEY.@{UI}
A: Leave NODELIST-DIR entry in BARNEY-PRefs empty and nodelist support
   is switched off.

@{I}Q: If I want to call a node but "call %n" trapdoor tries to dial the@{UI}
@{I}   nodenumber, not the phonenumber.@{UI}
A: Well, try this: "call %t boss %n". But the real problem is that
   you've got trapdoor installed wrong. Have you installed the
   nodelist and compiled?

@{I}Q: I have no NODELIST installed and BARNEY's nodelist support tuned@{UI}
 @{I}  off. But every time a call a node nothing is send or requested.@{UI}
A: Try this in caller parameter: "call %t boss %n". TrapDoor must know
   which node is called to send the request list.

@{I}Q: Do I really have to add a phonebook entry for every filelist?@{UI}
A: Yes. There is no "look filelist requester". Sorry! (I think, if you
   have a listlist of someone why not look in it sometimes for
   something?)

@{I}Q: Why is there only one unit length for every phonebook entry@{UI}
@{I}   possible? We have different unit length every day (e.g. Germany@{UI}
@{I}   8.00 - 18.00 h).@{UI}
A: Well, I think, most time when you request it is the cheapest
   time... The other thing is - how should BARNEY know at which time
   you want to request??
   (If you really need it make two phonebook entrys for this - one
   with the short unit length (e.g. 360 s) the other with the long
   length (e.g. 720 s).)

@{I}Q: Every time I call a node for request I got a password error.@{UI}
A: Look at your traplist config. Is there a line
   PASSWORD <this Nodenumber> "<Password>"
   If not - add it (your session password for this node).
   If there is one check your BARNEY prefs/caller parameters. If the
   parameter "%n" in it (e.g. "call %n" or "call %t boss %n")? If not,
   change it like shown before (the first one only if you have
   nodelist installed).

@{I}Q: BARNEY's display flashes if I want to select a file for request.@{UI}
A: This is because BARNEY can't parse the line. Since version 1.02 you
   can change the line pattern. If you don't know how send me a sample
   of this filelist and I'll make this for you. But don't be surprised
   - this freature is only available in registered version!
    

   Some  general  words.  Most  troubles  durring  calling  a node for
request  come  from  wrong installed trapdoor/traplist. Check this! If
you  really  find  nothing  or don't know how, don't worry and ask me.
Maybe you really found a BARNEY bug! :)
@ENDNODE
@NODE Versions_of_Barney "Versions list"
@TOC MAIN

** Versions of Barney **


                    @{" < 0.20   " LINK <_0_20}          @{"   0.28   " LINK 0_28}
                    @{"   0.20   " LINK 0_20}          @{"   0.29   " LINK 0_29}
                    @{"   0.21   " LINK 0_21}          @{"   1.00   " LINK 1_00}
                    @{"   0.22   " LINK 0_22}          @{"   1.01   " LINK 1_01}
                    @{"   0.23   " LINK 0_23}          @{"   1.01b  " LINK 1_01b}
                    @{"   0.24   " LINK 0_24}          @{"   1.02   " LINK 1_02}
                    @{"   0.25   " LINK 0_25}          @{"   1.03   " LINK 1_03}
                    @{"   0.26   " LINK 0_26}          @{"   1.04   " LINK 1_04}
                    @{"   0.27   " LINK 0_27}
@ENDNODE
@NODE <_0_20 "< 0.20"
@TOC Versions_of_Barney

< 0.20   : well working test releases

@{" 0.20 " LINK 0_20}
@ENDNODE
@NODE 0_20 0.20
@TOC Versions_of_Barney

  0.20   : visual feedback added

@{" 0.21 " LINK 0_21}  
@ENDNODE
@NODE 0_21 0.21
@TOC Versions_of_Barney

  0.21   : removed much bugs caused by visual feedback

@{" 0.22 " LINK 0_22}
@ENDNODE
@NODE 0_22 0.22
@TOC Versions_of_Barney

  0.22   : removed some more bugs caused by visual feedback
           wrote short english documentation
           made english catalogs

@{" 0.23 " LINK 0_23}
@ENDNODE
@NODE 0_23 0.23
@TOC Versions_of_Barney

  0.23   : small bug fixes

@{" 0.24 " LINK 0_24}
@ENDNODE
@NODE 0_24 0.24
@TOC Versions_of_Barney

  0.24   : new freature in visual feedback - CTRL to abort selection,
           added DOS version string to prefs file

@{" 0.25 " LINK 0_25}
@ENDNODE
@NODE 0_25 0.25
@TOC Versions_of_Barney

  0.25   : wow, it's done! Reqtools support in file, screenmode and
           system requesters. Colour requester choosing removed
           (well, my requester is much easier to handle - no reading
           of those colormap entries with graphics.library)
           RETURN for file selection works again (well, again bug
           caused by change to visual feedback)

           CTRL to abort key selection now works (every time....:)

@{" 0.26 " LINK 0_26}
@ENDNODE
@NODE 0_26 0.26
@TOC Versions_of_Barney

  0.26   : added PHONEBOOK menu in main window and menu switch in
           phonebook - so every node (filelist) can be loaded by
           pull-down menu

@{" 0.27 " LINK 0_27}
@ENDNODE
@NODE 0_27 0.27
@TOC Versions_of_Barney

  0.27   : unpack window added to phonebook, prefs "unpack dir" added

@{" 0.28 " LINK 0_28}
@ENDNODE
@NODE 0_28 0.28
@TOC Versions_of_Barney

  0.28   : unpack function added, auto unpacker detection in phonebook

           while iconify locale catalog, reqtools.library and
           traplist.library are closed

           bug fix - phonebook delete last entry made keyboard up/down
           impossible, "new" button didn't "press"

@{" 0.29 " LINK 0_29}
@ENDNODE
@NODE 0_29 0.29
@TOC Versions_of_Barney

  0.29   : Enforcer-Hits removed (I hope so ;-))
           ("why were there no crashs?? ;-)")

           all ASCII codes in filelists below #32 are replaced by
           #32 (space) (expect #10 (LF) and #13 (CR)) 
           ("why are there FF (#12) in filelists????")

           filelist listview now expands to full screen width, was
           already in V0.28 with some troubles
           ("why are some filelists longer than 80 chars per line?")
           
           FarbRequester was changed in V0.26 or so - I forgot to
           write this in this list (uops :) because this requester is
           part of my functions collection which is also part of other
           programs and when I link a program next time the new
           freatures are added and I don't remember it.... ;-)
           
           internal handling of gadget keys and visual feedback
           changed (in V0.25 was the first step, now it has finished)

@{" 1.00 " LINK 1_00}
@ENDNODE
@NODE 1_00 1.00
@TOC Versions_of_Barney

  1.00   : ATTENTION! version 0.29 was not published - but was no fake
  ----         
           added phone number entry in phonebook and updates call
           function (don't forget to change call prefs if you use this
           new freature!)
           
           low memory handling: if AllocMem() or OpenWindow() (...)
           fails Barney first frees the filelist in memory and then
           opens a message requester
           
           some gadgets in phonebook are now locked if no entry is
           selected (empty phonebook) - again! (this bug was a result
           of the visual feedback again :(
           
           update of english catalogs (as always!)
           
           now SHAREWARE - no pre-release!
           
           BugFix in phonebook

@{" 1.01 " LINK 1_01}
@ENDNODE
@NODE 1_01 1.01
@TOC Versions_of_Barney

  1.01   : BugFix in "while search" window - now busy pointer is shown
           (again, like before v1.00)
           
           empty NODELIST field in prefs supported to switch of
           traplist support
           
           listview scrollbar now 2 point larger (looks a bit better)
           
           cancel gadget in phonebook, some short cuts changed
           
           catalogs changed!!
           
           new freature: add request of other node
           
           screen height can't be smaler than 200
           
           TAB key to activate a string gadget in each window
           (this is much user friendlyer than activate this gadgets
           at once)
           
           added FILES request from phonebook
           
           now every paragraph in the doc has 3 spaces at the
           beginning (seems I were a bit crazy when I wrote it first
           with 3, sometimes 2 spaces ;-))
           
           using RIGHT_AMIGA function of my VisualFeedback function
           (allows selecting gadget from string gadget by key)
           
           some tooltypes for WB start added
           
           wrote C= installer script
           
           0-byte filelists caused an internal error
           (exec don't like AllocMem(0,...) :)
           
           front spaces in line parsing now allowed
           
           searching is now much more faster
   
@{" 1.01b " LINK 1_01b}
@ENDNODE
@NODE 1_01b 1.01b
@TOC Versions_of_Barney

  1.01b  : (not published in AmigaNet!)
           a really old bug was found
           (seams this made much trouble!)
           if CPS or unit length were set to 0 (ZERO!) Barney made
           a devision by zero after loading filelist

@{" 1.02 " LINK 1_02}
@ENDNODE
@NODE 1_02 1.02
@TOC Versions_of_Barney

  1.02   : NO ON SHOWN switch (good idea of Christoph Granz)
           (Tooltype "NOONSHOWN")
           (was in earlyer beta releases ONSHOWN switch)

           BugFix in Prefs/Visual Feedback

           EXTRAS button in phonebook
           EXTRAS window
           EXTRAS menuitem in main window
           
           area jump

           now handles 4 letter year correct
           (before e.g. 1994 was always the year 19)
           
           ListView is more intelligent now in scrolling
           (e.g. if you are in the top line and move 1 down by cursor
           keys there will be no jump like before)
           
           show list in phonebook removed - made much internal trouble
           and wasn't so useful
           
           phonebook REPLACE function changed and button removed
           new buttons added -> catalogs changed, please update!
           
           files that are already in the request list are now marked
           in files view (.BX file changed)
           
           now "XXX has been changed, save it?" requesters ask only if
           you have really changed something
           
           Call program parameter string now 60 letters long
           
           editable pattern of line parser
           
           internal VisualFeedback gadget handling completely changed
           better looking of gadget text now
           
           "Prefs" item in phonebook menu, really, there is no
           screenmode selection possible!
           
           extras window string gadget have now cursor up/down support
           
           BX/REQ flags in phonebook and switch in prefs
           
           Enforcer-Hit in Shareware-Key-checking remove, old
           key-files had to be updated :-(
           
           Installer-Script changed (now font is copied, oops ;-)
           
           example phonebook added to archive (install script changed)
           
           well, it's time to pack and publish it.....

@{" 1.03 " LINK 1_03}
@ENDNODE
@NODE 1_03 1.03
@TOC Versions_of_Barney

  1.03   : Comment shown in request view,
           comment saved in .BX file
           (listview changed for request view)
           
           some small bugs in BX/REQ flags removed
           (were not always changed)
           some more bugs with BX/REQ flags removed
           (sometimes flags were cleared after moving)

           GUI window in prefs window for all screen options          
           
           Barney made fully font sensitiv - I hope it works, this is
           the 4th program that uses my new sensitiv gadget unit

           some window graphics changed for better looking

           Bugs in MANUEL input removed (change something was
           impossible when done by entering name by hand)
           
           multiselect in request view
           
           multi manuel edit, multi remove file

           password length set from 10 to 20

           new tooltype LISTMATCHOFF
           
           ADDRESS keyword from CLI

           EXTRAS menuitem in main window removed (made trouble) 

           Inbound directory added in prefs, 
           change of internal DOS-prefs structure
           
           "copy filelist from INBOUND" added in phonebook

           phonebook "EXTRAS" pulldown menu changed

           phonebook bugfix when cursor up/down was used for first
           time a node could be overwritten
           
           main window gadgets reorganized for font sensitivity
           
           today (18-07-94) my modem was destroyed by high power :-(
           so I had time to work in BARNEY but no way to send it my 
           beta testers

           bugfix in ONSHOWN mode when CURSOR UP was used the
           calculation function made something but nothing good
           (jumped somewhere)

           own unpack drawer to delete ALL filelist files

           screens with more than 4 colour

           colours setup

           automatic detection of unpacked filelist names


@{" 1.03a " LINK 1_03a}
@ENDNODE
@NODE 1_04 1_04
@TOC MAIN

  1.04 :   GUI prefs window changed (cycle gadget to listview)
           (listview hook added)

           BugFix: sometimes a not selectable line could be selected
           (if one one word was in this line, this line was not
           scanned before and a file was selected just before)

           localized filesize

           V 1.03 crashed with empty phonebook

           listviews of js_tools.library (will be published soon)

           long filelist could be loaded in small parts into memory

           using quicksort of js_tools.library in phonebook


  1.04a:   some heavy BugFixes in Barney and js_tools
           Enforcer-Hits removed (first startup works again....)

           font in phonebook listview can be now proportional!


@{" 1.05 " LINK 1_05}
@ENDNODE
@NODE 1_05 1_04
@TOC MAIN

  1.05   : Well, currently there are no new ideas for V1.05!

           BUT! If YOU have ideas @{"WRITE" LINK Addresses} them down!


@{" List " LINK Versions_of_Barney}
@ENDNODE
@NODE Guide-Intern Guide-Intern
@TOC MAIN
@NEXT Advertising
@PREV main
Hauptmenü-Info

Abstand: 8

                              |        |

                              |        |

Internes:

      GuideGen - Version 0.85 (31.07.94) - (c) 1994 by J.Schmitz

                         not fully published!

                      pre-release "GUIDEGEN.LHA"

                             SHAREWARE!!

              Look for file area 39 at RHLB (2:2454/550)
@ENDNODE
@NODE Advertising Advertising
@TOC MAIN
@NEXT main
@PREV Guide-Intern
You can see Barney, you can read Barney, you can use Barney, and now
you can even HEAR Barney! Yes' it's true. Together with Fred, Wilma
and other Bedrock he performed a fabulous song and this wonderful piece
of music is available in every good sorted mail box. Just look out for
BARNEY.MOD - if you heard it once you want to hear it every time....

Barney.mod - that's what we call music


:
: Matthias
: Wege
:



REQUEST FOR "BARNMOD.LHA" ON 2:2454/550 or /551 (or /552 for ISDN)
@ENDNODE
