Show
Ignore:
Timestamp:
10/06/08 00:29:29 (15 years ago)
Author:
jerome
Message:

Removed trailing spaces.

Files:
1 modified

Legend:

Unmodified
Added
Removed
  • pykoticon/trunk/README

    r176 r3439  
    2222PyKotIcon is a cross-platform client-side helper for PyKota. 
    2323 
    24 It is meant to be launched whenever the user logs in, and stay in  
    25 the taskbar (depending on the client operating system) until the  
    26 user closes his session.  
    27    
     24It is meant to be launched whenever the user logs in, and stay in 
     25the taskbar (depending on the client operating system) until the 
     26user closes his session. 
     27 
    2828Installation : 
    2929 
    3030  * GNU/Linux and similar : 
    31    
     31 
    3232    $ cd pykoticon 
    3333    $ python setup.py install 
    34      
     34 
    3535    Then modify your .xsession file, or the appropriate file depending 
    3636    on your desktop environment, to ensure that the pykoticon command 
    3737    is launched in the background each time your X Window session 
    3838    starts. 
    39      
     39 
    4040    You MUST pass the list of hostnames or IP addresses from which 
    4141    PyKotIcon should accept incoming connexions on pykoticon's 
     
    4444    hostnames or IP addresses of ALL print servers on pykoticon's 
    4545    command line. 
    46      
     46 
    4747    NB : `pykoticon --help` will give you hints about the expected 
    4848    command line parameters. 
    49      
    50   * MS Windows :   
    51    
    52     Download pykoticon-x.yy.zip from  
    53      
     49 
     50  * MS Windows : 
     51 
     52    Download pykoticon-x.yy.zip from 
     53 
    5454        http://www.pykota.com/software/pykoticon/download/tarballs/ 
    55          
    56     Unzip it into a directory of its own. I usually unzip it into     
     55 
     56    Unzip it into a directory of its own. I usually unzip it into 
    5757    /var/lib/samba/netlogon/pykoticon/ 
    58      
     58 
    5959    Modify the PYKOTICON.VBS file to include the list of authorized 
    6060    print servers and change other parameters as needed, as explained 
    6161    in the GNU/Linux section above. 
    62      
     62 
    6363    Ensure that PYKOTICON.VBS is executed each time an user logs 
    6464    in. The easiest way to do this is in STARTUP.CMD : 
    65      
     65 
    6666      --- CUT --- 
    6767      SET PATH=%PATH%;\\MYSERVER\NETLOGON\PYKOTICON\ 
    68       \\MYSERVER\NETLOGON\PYKOTICON\PYKOTICON.VBS  
     68      \\MYSERVER\NETLOGON\PYKOTICON\PYKOTICON.VBS 
    6969      --- CUT --- 
    70        
     70 
    7171    NB : if you launch PYKOTICON.EXE directly instead of from 
    72     PYKOTICON.VBS, a small but disturbing window may appear on  
     72    PYKOTICON.VBS, a small but disturbing window may appear on 
    7373    the screen. 
    7474 
     
    8484  independant of PyKota, and can be used from any application 
    8585  which can do remote procedure calls over XML-RPC. 
    86    
     86 
    8787  PyKotIcon exposes 4 of its methods over XML-RPC, here they are : 
    88    
     88 
    8989    - nop : 
    90      
     90 
    9191      This methods does exactly nothing :) 
    92        
     92 
    9393      - Input : No argument. 
    94        
     94 
    9595      - Output : returns the True boolean value. 
    96        
    97     - quitApplication :   
    98      
     96 
     97    - quitApplication : 
     98 
    9999      This method causes the PyKotIcon application to exit. 
    100        
     100 
    101101      - Input : No argument. 
    102        
     102 
    103103      - Output : returns the True boolean value. 
    104            
    105     - showDialog :   
    106     
     104 
     105    - showDialog : 
     106 
    107107      This methods displays an informational message, and returns 
    108108      the choice the user made, if any. 
    109         
    110       - Input :  
    111          
    112         - message : a Binary XML-RPC object representing an UTF-8 encoded  
    113           character string which will be displayed to the end user.  
    114           This string can contain literal "\n" sequences which will  
     109 
     110      - Input : 
     111 
     112        - message : a Binary XML-RPC object representing an UTF-8 encoded 
     113          character string which will be displayed to the end user. 
     114          This string can contain literal "\n" sequences which will 
    115115          be automatically expanded into line breaks by PyKotIcon. 
    116            
    117         - confirmation : a boolean value indicating if the user will   
     116 
     117        - confirmation : a boolean value indicating if the user will 
    118118          be given the choice to valid or cancel (True), or only 
    119119          to valid (False) the dialog box. 
    120              
    121       - Output :       
    122        
     120 
     121      - Output : 
     122 
    123123        - the literal string "OK" if the user clicked on the OK button, 
    124124          else the literal string "CANCEL". The latter is only possible 
    125125          if the method was called with its second parameter set to 
    126126          True. 
    127          
    128     - askDatas :       
    129      
     127 
     128    - askDatas : 
     129 
    130130      This method can generate an input form and return what the user 
    131131      entered in the different fields. 
    132        
     132 
    133133      - Input : 
    134        
    135         - An array of labels, one label per input field in the  
     134 
     135        - An array of labels, one label per input field in the 
    136136          form to be created. Each label in the list is passed as 
    137137          a Binary XML-RPC object representing an UTF-8 encoded 
    138138          character string. 
    139            
     139 
    140140        - An array of variables names, one name per input field in 
    141141          the form to be created. Each name in the list is passed 
    142           as an ASCII encoded character string.  
     142          as an ASCII encoded character string. 
    143143          IMPORTANT : if one of these names is 'password' then this 
    144           particular field's input box will be visually protected  
     144          particular field's input box will be visually protected 
    145145          with * in place of the characters typed during input. 
    146            
    147         - An associative array (e.g. Python mapping) of initial values.  
     146 
     147        - An associative array (e.g. Python mapping) of initial values. 
    148148          Each key is a variable name which must be present in the list 
    149149          above, and each value is a possibly empty initial content, 
    150           which will be passed as a Binary XML-RPC object representing  
     150          which will be passed as a Binary XML-RPC object representing 
    151151          an UTF-8 encoded character string. 
    152        
     152 
    153153      - Output : 
    154        
     154 
    155155        - An associative array (e.g. Python mapping) containing the 
    156156          variables names as keys and the variables' contents as 
    157157          values in the following format : 
    158            
     158 
    159159          - Each key is an ASCII encoded character string representing 
    160             the name of a variable to ask which was passed from the  
     160            the name of a variable to ask which was passed from the 
    161161            caller. 
    162              
    163           - Each value is a Binary XML-RPC object representing an UTF-8   
     162 
     163          - Each value is a Binary XML-RPC object representing an UTF-8 
    164164            encoded character string, itself being the result of user 
    165165            input in the form's field for this particular variable. 
     
    173173            In this case, all the other values are empty strings 
    174174            anyway. 
    175              
    176              
    177 IMPORTANT : PyKotIcon doesn't currently support encrypted connexions,             
     175 
     176 
     177IMPORTANT : PyKotIcon doesn't currently support encrypted connexions, 
    178178so if you're afraid of sensitive information flying in the clear 
    179 over the nework, you should probably install a transparent secure  
     179over the nework, you should probably install a transparent secure 
    180180tunneling software like stunnel on both sides of each connection. 
    181181 
    182182==================================================================== 
    183      
     183 
    184184Please e-mail bugs to the PyKota mailing list at : pykota@librelogiciel.com 
    185185or to the main author at : alet@librelogiciel.com (Jerome Alet)