doc: add generation of man pages from asciidoc sources

[libam7xxx.git] / README.asciidoc

diff --git a/README.asciidoc b/README.asciidoc
index 011ad9f..133c13b 100644 (file)
--- a/README.asciidoc
+++ b/README.asciidoc
@@ -24,17 +24,20 @@ is at: http://wenku.baidu.com/view/543c8b4d852458fb770b56ee.html
 
 == Supported devices
 
 
 == Supported devices
 

-The devices supported by libam7xxx use USB bulk trasfers and a simple packet
+The devices supported by libam7xxx use USB bulk transfers and a simple packet

 based protocol to exchange data and commands to and from a host system and the
 AM7XXX chip.
 
 based protocol to exchange data and commands to and from a host system and the
 AM7XXX chip.
 

-Those with USB VendorID +1de1+ are devices based on Actions Micro/Action Media
-designs, usually having two modes:
+Devices based on Actions Micro/Action Media designs generally use the USB
+VendorID +1de1+, and they can have two operational modes:

 
 

- - USB Mass Storage mode (ProductID: +1101+)
- - Generic bulk data transfer mode (ProductID: +c101+)
+ - USB Mass Storage mode (e.g. ProductID: +1101+)
+ - Generic bulk data transfer mode, or Display mode (e.g. ProductID: +c101+)

 
 

-The mode can be switched with the command:
+On recent GNU/Linux systems the switch from Mass Storage mode to Display mode
+is performed automatically by
+http://www.draisberghof.de/usb_modeswitch/[USB_ModeSwitch], or can be done
+manually with the command:

 
  $ sudo usb_modeswitch \
    --default-vendor 0x1de1 \
 
  $ sudo usb_modeswitch \
    --default-vendor 0x1de1 \


@@ -43,7 +46,7 @@ The mode can be switched with the command:
 
 Examples of devices based on AM7XXX are:
 
 
 Examples of devices based on AM7XXX are:
 

-  - Acer Series C pico projectors (C20 C110 C112 C120):
+  - Acer Series C pico projectors (C20, C110, C112):

       * http://www.acer.it/ac/it/IT/content/models/projector-c
       * http://support.acer.com/product/default.aspx?modelId=3888
     
       * http://www.acer.it/ac/it/IT/content/models/projector-c
       * http://support.acer.com/product/default.aspx?modelId=3888