home *** CD-ROM | disk | FTP | other *** search
/ Amiga Times / AmigaTimes.iso / programme / trionbbs110 / Trion / docs / Utils / fileed.doc < prev    next >
Encoding:
Text File  |  1998-10-06  |  4.6 KB  |  116 lines
  1.  
  2.  
  3.  
  4.    =====( FileEd V1.00 )=============================================
  5.  
  6.  
  7.         Trion offline GUI FileEditor.
  8.  
  9.         (c) Copyright Paul Spijkerman, '96-'97. All rights reserved.
  10.  
  11.         Written for use with the Trion BBS package.
  12.  
  13.  
  14.    ===================================================================
  15.  
  16.  
  17.    The programm called FileEd is the offline GUI FileCatalogue
  18.    Editor of the Trion BBS package.
  19.    There is also a simple file editor in the BBS programm itself
  20.    wich we will revere to as the "online editor".
  21.  
  22.    The GUI windows of the File editor are dynamic, you can resize
  23.    them and they render them self using all the space in the window.
  24.    The list with users becomes shorter or longer and the space
  25.    between buttons and other GUI elements changes.
  26.    Also GUI elements like buttons can change size to better use the
  27.    window space .. This depends on what is usefull in Utilities.
  28.  
  29.    You can start it by typing FileEd in shell or by Clicking on
  30.    the Files button in TrionRM monitor or the GuiMod programm.
  31.    If it was run this way you find yourself in the section list
  32.    to select a file section.
  33.  
  34.    You select a file section by clicking once on a section
  35.    name. When you selected a section you are in the file list.
  36.  
  37.    You can select a file by double clicking on them,
  38.    or click one time on a file and click on the "Edit" button or by
  39.    typing return in the file string gadged.
  40.    The filelist has a wildcard option, you can type a search
  41.    string in the "Show" string gadged and only matching files
  42.    will be shown in the Filelist.
  43.  
  44.    Note that if you click on the Delete button in the file list,
  45.    the file is removed from the file catalogue, but the fysical
  46.    file is moved to the killed files directory.
  47.  
  48.  
  49.    If you start it from shell with a name on the commandline or
  50.    you click on a file name in the Maintenance monitor the
  51.    FileEditor will load a File at run time and you
  52.    find yourself in the FileEdit part of the programm.
  53.  
  54.    Note that if you start the programm from shell you have
  55.    to put the name on the command line between "" if it
  56.    contains spaces.
  57.  
  58.  
  59.  
  60.    The file editor has a simple DescriptionEditor which needs
  61.    a little work because it is a difficult subject.
  62.  
  63.    A long time ago a description was just a long line of
  64.    characters without returns, showing was relativly easy
  65.    it was just a wordwrap add the end of the line on a
  66.    space and then skip the next spaces.
  67.  
  68.    Then came formatted descriptions with returns in it.
  69.    (descriptions from File_ID.diz files).
  70.    Now you have to go to the next line if you see a return 
  71.    but also do the wordwrap thing, but you cannot skip the
  72.    spaces at the beginning of the line .. because some 
  73.    formatted File_ID.diz descriptions become very messy.
  74.    So when showing a file the BBS first checks if there
  75.    are returns and if there are space at the beginning
  76.    of the line are not skipped.
  77.  
  78.    Editing something like this is not easy .. because
  79.    some lines in the editor end with a return and
  80.    some are wrapped. If the description is saved after
  81.    editing the wordwrapped lines can't have returns
  82.    after them because they become a mess. So you can't
  83.    use a normal full screen editor.
  84.  
  85.    So I use the line editor with 2 special characters, the
  86.    'inverted P' is the end of a line marker (word wrap or
  87.    return) .. and a '>>' character means that the line
  88.    was terminated with a return. So don't remove those
  89.    characters because you will be creating a real mess.
  90.  
  91.    The descriptions are shown in the line editor at the
  92.    same way they are shown in the BBS .. exept spaces
  93.    before the end of the line marker are trown away
  94.    because of the way lines are saved.
  95.    When the description is saved the lines from
  96.    the line editor are written to disk with a character
  97.    between the lines. If the line ended with a return the
  98.    character is a return ofcouse.. but if the line was wrapped
  99.    (so there was no return) a space is placed between lines
  100.    so words from differend lines are not glued together.
  101.  
  102.    Editing goes something like this.
  103.    If you click on a line it is copied to the stringgadget
  104.    under the descriptions. where you can edit the line.
  105.    If you click on an other line the line you edited is
  106.    copied back and a new line is copied to the editor.
  107.    Also when you press return in the stringgadget it is
  108.    copied back to the description.
  109.    You can add lines to the description by clicking on
  110.    the first empty line beneath the description .. the
  111.    empty line is copied to the stringgadget .. and when it
  112.    is copied back there will be an 'inverted P' at the end.
  113.    When you click on the Update button all lines to the
  114.    first empty line will be saved.
  115.  
  116.