Re: [as-devel] AfterStep User's Guide

Ethan (allanon@crystaltokyo.com)
Fri, 30 Jul 1999 01:28:35 -0700 (PDT)



On Thu, 29 Jul 1999, Steven Baker wrote:

>   This is the outline for the AfterStep User's Guide, it is liable to
> change at any time without notice.  Updates, modifications, etc are
> welcome and appreciated.
>
> Introduction
>   Overview                    Overview of what AfterStep is, and what
>                               it does.
>   History                     The evolution of AfterStep.
>   Features                    Features available in AfterStep.
>   Philosophy                  The philosophy of AfterStep, modules,
>                               etc.
>
> Getting Started
>   Installation
>     Source                    How to compile and install AfterStep.
>     Binary                    How to download and install AfterStep.
>   Starting AfterStep          QaD on starting AS for the first time.
>   Introduction to the UI      Simple introduction on how to interact
>                               with the DEFAULT look and feel.

This is largely covered in the FAQ, but since the FAQ is pretty much
unmaintained at the moment (sorry, Andrew!), it might be worth doing
again.

> Configuration                 How to configure AfterStep.  This will
>                               probably be the largest section of the
>                               User's Guide.

No "probably" about it - this would definitely be the largest section,  
unless each topic said "See manual page for xxx."  In fact, this would  
be so large (and this is what man pages are for, anyway), that I'd 
suggest a section on themes instead.  Or maybe just work on ascp, to 
make configuration so much easier that a guide isn't necessary. :)

----
Ethan Fischer
allanon@crystaltokyo.com
http://members.xoom.com/allanon1