--------------------------------------------------------------------
--- Libretto BIOS Setting Program for Linux Version 1.0  -----------
---                                       1998/06/19  --------------
--------------------------------------------------------------------

1. Preface
--------------------------------------------------------------------
     The `libapm' is a utility program to configure the BIOS setting 
of the mini notebook computer, Toshiba Libretto. Changes to the 
setting are immediately done, so rebooting is not necessary.
     I don't know whether these programs work on any other machines
but Libretto. In case of Toshiba's notebook machines, some function 
may work. 

*** Disclaimer *****************************************************
     The information used to write these programs was obtained by 
analyzing Libretto individually, not provided by Toshiba. Therefore,
they might contain fatal bugs and might cause damages to your 
Libretto. You can use them freely but the authors are not 
responsible for the programs. Redistribution of the programs are not
restricted, but you must attach this caution and the source. 
********************************************************************

    The original program were written by Mr. Iizuka 
(PXN02133@niftyserve.or.jp), which rewrite the CMOS setting 
directly. Mr. Nomura (GBB00111@niftyserve.or.jp) have extended the 
program to support SMI and BIOS calling. Thanks.
    I, Ishioka, combined programs to the package. If you have any 
troubles, bug reports, or requests, please notify me.


2. Installation
--------------------------------------------------------------------
Edit Makefile, then `make ; make install'.

BINDIR is a target directory where libapm is installed.
MANDIR is a target directory where libapm.man is installed.
MANSECT is a section where libapm.man belongs.
MANLANG is language of the man page. e: English, j: Japanese

If the define -DLIBRETTO of CFLAGS are commented out, libapm do not
check whether the machine is Libretto or not. At this version, only
Libretto 20, 30, 50 can be checked, so the -DLIBRETTO is disabled 
at default. (Libretto 20 and 30 were sold in Japan only.)

If you do `chmod -m 4755 libapm', anyone can run libapm. But I 
don't think this is good idea. I recommend you to use sudo.


3. Usage
--------------------------------------------------------------------
If no options are specified, current status is output.

% libapm
Power Management for Libretto V1.0
+-----------------------------------------------------------+
|   0) Power-up Mode      : Hibernation                     |
|   1) Standby Time       : 0 min                           |
|   2) System Auto Off    : Disabled                        |
|   3) Panel Power On/Off : Disabled                        |
|   4) Alarm Power On     : Disabled                        |
|   5) LCD Power          : 0                               |
|   6) Volume             : low                             |
|   7) Off (Suspend/Hiber): Unknown                         |
+-----------------------------------------------------------+

The item 7) is available on 100CT (and later? :-).
Available options are displayed by doing `libapm -h' or 
`libapm --help'.

% libapm --Help
usage: libapm [-v --Version]
              [-h --Help]
              [-P --PowerUp {boot,hibernation}]
              [-T --StandbyTime {0,5,10,15,30,45,60}]
              [-a --AutoOff {disable,10,20,30,40,50,60}]
              [-S --PanelSwitch {disable,enable}]
              [-A --PowerOn {disable,<timei>}]
              [-L --LcdPower {0,1,2,3}]
              [-V --Volume {0,1,2,3}]
              [-O --Off {suspend|hibernation}]

To configure various setting,
o To enable hibernation 
    % libapm --PowerUp hibernation

o To set Standby time 10 min. after hibernation
    % libapm --StandbyTime 10

o To set Auto off timer 60 min.
    % libapm --AutoOff 60

o To set brightness of the LCD maximum
    % libapm --LcdPower 3

o To enable Panel Switch
    % libapm --PanelSwitch enable

o To turn off beep sound
    % libapm --Volume 0

o To set Power-On time at 13:50
    % libapm --PowerOn 13:50

--- History ---------------------------------------------------------
version 1.0beta5:
  1998/06/19
  added new information to APM-EXBIOS.txt. (by SHIMAZAKI)
  added english documents to archive. (translated by SHIMAZAKI)

version 1.0beta4:
  1998/06/03
  Official Release.

version 1.0beta3:
  1998/6/19
  made public with documents attached.
  arranged a part of options, and added short options.

version 1.0beta2:
  Mr. Nomura's patch were applied and changed direct-rewriting of 
  CMOS to rewriting through the BIOS.  
  + Bug fix(ishioka@ppp01.infopepper.or.jp).

version 1.0beta:
  Mr. Iizuka made the original program. (Not publicly available)

The origin of this program is libapm12.lzh which runs on MS-DOS and
is available from NIFTY SERVE (BBS in Japan). the libapm12.lzh was 
written by Mr. Iizuka.

--------------------------------------------------------------------
This document was written by T. Ishioka 
(ishioka@ppp01.infopepper.or.jp) and translated into English by 
Y. Shimazaki (yamatori@ab11.yamanashi.ac.jp). Any question or 
suggestion to this document, are welcome.