EditPrefs 5.4 Contents
**********************

@Remark $VER: EditPrefs_guide 5.4 (26.2.97)

@{" ARexx         " Link "EditPrefs-rexx/Main"} ARexx Interface

@{" AutoDocs      " Link "Docs/MPGui.doc/Main"} MPGui.library AutoDocs

Quick overview
**************

EditPrefs provides a GUI to allow editing of prefs files which are in the format:

Setting=Value Switch etc.

Software and Hardware required
******************************

Requires OS3.0+.

Also needs MPGui.library (included).

Shell Parameters
****************

The command line is:

EditPrefs DIR/K/A,SAVEDIR/K/A,FILE/K/A,HELP/K/A,DEFAULT/K/A,GUI/K/A,PORTNAME/K.

DIR parameter
=============

This specifies the name of the directory where the prefs file should be saved when the 'Use' gadget is clicked.

It should end with : or /.

SAVEDIR parameter
=================

This specifies the name of the directory where the prefs file should be saved when the 'Save' gadget is clicked.

It should end with : or /.

FILE parameter
==============

This specifies the name of the file to save the prefs in when the 'Use' or 'Save' gadget is clicked.

HELP parameter
==============

This specifies the name of the AmigaGuide file from which help will be displayed when the Help key is pressed.

DEFAULT parameter
=================

This specifies the name of the file where the default prefs are held.

The format of the file is:

; comment line

A Comment

GadgetTitle1=SettingsPrefix=DefaultValue

Used where "SettingsPrefix=DefaultValue" is to be written

GadgetTitle2==List Values=Default Values

Used for an MLIST where multiple switch values are to be written.

Prefixing a line with a + means that that setting will not be reset to the default value when "Reset To Defaults" is chosen.

GUI parameter
=============

This specifies the name of the GUI file to be used with MPGui.library.

Parameters should be specified as #n# (n starting as 0). These should be in the same order as the DEFAULT file.

See @{"Docs/MPGui.doc" Link "Docs/MPGui.doc/Main"}.

PORTNAME parameter
==================

This specifies the name to use as an ARexx port. If not supplied then no ARexx port is created.

See @{"Docs/MPGui.doc" Link "Docs/MPGui.doc/Main"}.

Menus
*****

Project Menu
============

Project/Open... Menu Item
-------------------------

Shows a file requester to open prefs from a file.

Project/Save As... Menu Item
----------------------------

Shows a file requester to save prefs to a file.

Project/Quit Menu Item
----------------------

Quits EditPrefs without saving prefs.

Edit Menu
=========

Edit/Reset To Defaults Menu Item
--------------------------------

Resets the prefs to the default settings.

Edit/Last Saved Menu Item
-------------------------

Resets the prefs to the values that were last Saved.

Edit/Restore Menu Item
----------------------

Resests the prefs to the values that were last Used.

Settings Menu
=============

Settings/Create Icons? Menu Item
--------------------------------

Switches if an Icon should be saved with the prefs file.

The Icon used is:

1  The existing Icon;

2  def_prefs.info in the Use directory;

3  ENV:SYS/def_prefs.info;

4  The default Project Icon.

Known (and unknown) errors
**************************

The docs are a bit sparse.

Version History
***************

  * Version 5.4 26/2/97

       * Now tries to open locale.library(38) to work on OS3.0.

  * Version 5.3 16/2/97

       * Non beta version of 5.2.

       * Added install script and moved library location.

  * Version beta1 5.2 14/11/96

       * Recompiled with SAS/C 6.57.

       * Localised.

  * Version 5.1 12/8/96

       * Updated version number.

  * Version 5.0 8/5/96

       * Source code released - GNU license.

       * Only opens version 34 of amigaguide.library. Thanks to Thomas Byrer

       * Refreshes windows when a requester is open

  * Version 4.2 24/3/96

  * Version 4.1 10/3/96

       * Updated this doc.

  * Version 4.0 19/2/96

       * Released to CIX.

Copyright and distribution requirements
***************************************

      EditPrefs - Amiga Prefs editing program
      Copyright (C) © 1996 Mark John Paddock

      This program is free software; you can redistribute it and/or modify
      it under the terms of the GNU General Public License as published by
      the Free Software Foundation; either version 2 of the License, or
      any later version.

      This program is distributed in the hope that it will be useful,
      but WITHOUT ANY WARRANTY; without even the implied warranty of
      MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
      GNU General Public License for more details.

      You should have received a copy of the GNU General Public License
      along with this program; if not, write to the Free Software
      Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.

      mark@topic.demon.co.uk
      mpaddock@cix.compulink.co.uk

EditPrefs IS PROVIDED "AS-IS" AND SUBJECT TO CHANGE; NO WARRANTIES ARE MADE.  ALL USE IS AT YOUR OWN RISK.  NO LIABILITY OR RESPONSIBILITY IS ASSUMED.

EditPrefs is ©1996 Mark John Paddock

Please send any criticisms, bugs, etc. by EMail to mark@topic.demon.co.uk or mpaddock@cix.compulink.co.uk.

Note - the source code to EditPrefs (not MPGui.library) is freely distributable and is not covered by the above license.