*
 *  This program is free software: you can redistribute it and/or modify
 *  it under the terms of the GNU Affero General Public License as
 *  published by the Free Software Foundation, either version 3 of the
 *  License, or (at your option) 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 Affero General Public License for more details.
 *
 *  You should have received a copy of the GNU Affero General Public License
 *  along with this program.  If not, see 
'; echo t('This interface permits to script your uploads and downloads.') . ' ' . t('The instructions above show how to query this interface.'); echo '
'; echo '';
    echo t('Send a GET query to') . ': ' . $web_root . 'script.php
';
    echo '
';
    echo t('Parameters') . ':
';
    echo "get_version=1 (" . t('Required') . ") 
";
    echo '
' . t('This will return brut text content.') . ' ' .
            t('First line is the version number.') . '
'; echo t('Example') . ": " . $web_root . "script.php?get_version=1 "; echo '
'; echo '';
    echo t('Send a GET query to') . ': ' . $web_root . 'script.php
';
    echo '
';
    echo t('Parameters') . ':
';
    echo "get_capacity=1 (" . t('Required') . ") 
";
    echo '
' . t('This will return brut text content.') . ' ' .
            t('First line is the server capacity (in Bytes).') . '
'; echo t('Example') . ": " . $web_root . "script.php?get_capacity=1 "; echo '
'; echo '';
    echo t('Send a POST query to') . ': ' . $web_root . 'script.php
';
    echo '
';
    echo t('Parameters') . ':
';
    echo "file=C:\\your\\file\\path (" . t('Required') . ") 
";
    echo "time=[minute|hour|day|week|month|none] (" . t('Optional') . ', '. t('default: none') . ") 
";
    echo "password=your_password (" . t('Optional') . ") 
";
    echo "one_time_download=1 (" . t('Optional') . ") 
";
    echo '
' . t('This will return brut text content.') . ' ' .
         t('First line is the download reference and the second line the delete code.') . '
';
    echo t('Send a GET query to') . ': ' . $web_root . 'script.php
';
    echo '
';
    echo t('Parameters') . ':
';
    echo "h=your_download_reference (" . t('Required') . ") 
";
    echo '
';
    echo t('If a password has been set, send a POST request with it.');
    echo '
';
    echo t('Parameters') . ':
';
    echo "password=your_password (" . t('Optional') . ") 
";
    echo '
'; echo t('Example') . ": " . $web_root . "script.php?h=30ngy0hsDcpfrF8zR7x9iU "; echo '
'; echo '';
    echo t('Send a GET query to') . ': ' . $web_root . 'script.php
';
    echo '
';
    echo t('Parameters') . ':
';
    echo "h=your_download_reference (" . t('Required') . ") 
";
    echo "d=yout_delete_code (" . t('Required') . ") 
";
    echo '
' . t('This will return "Ok" if succeded, "Error" otherwhise.') . '
'; echo t('Example') . ": " . $web_root . "script.php?h=30ngy0hsDcpfrF8zR7x9iU&d=0d210a952 "; echo '
'; echo '';
    echo t('Send a GET query to') . ': ' . $web_root . 'script.php
';
    echo '
';
    echo t('Parameters') . ':
';
    echo "lang=[";
    foreach ($script_langages as $lang => $name)
        echo $lang;
    echo "] (" . t('Required') . ") 
";
    echo '
' . t('This will return brut text content of the code.') . '
';
    echo t('Example') . ": 
";
    foreach ($script_langages as $lang => $name)
        echo "$name: " . $web_root . "script.php?lang=$lang ";
    echo '
'; echo t('The goal is to permit to transfert big file, chunk by chunk.') . ' '; echo t('Chunks of data must be sent in order.'); echo '
'; echo '';
    echo t('Send a GET query to') . ': ' . $web_root . 'script.php?init_async
';
    echo '
';
    echo t('Parameters') . ':
';
    echo "filename=file_name.ext (" . t('Required') . ") 
";
    echo "type=MIME_TYPE (" . t('Optional') . ") 
";
    echo "time=[minute|hour|day|week|month|none] (" . t('Optional') . ', '. t('default: none') . ") 
";
    echo "password=your_password (" . t('Optional') . ") 
";
    echo "one_time_download=1 (" . t('Optional') . ") 
";
    echo '
' . t('This will return brut text content.') . ' ' .
         t('First line is the asynchronous transfert reference and the second line the code to use in the next operation.') . '
';
    echo t('Send a GET query to') . ': ' . $web_root . 'script.php?push_async
';
    echo '
';
    echo t('Parameters') . ':
';
    echo "ref=async_reference (" . t('Required') . ") 
";
    echo "data=data_chunk (" . t('Required') . ") 
";
    echo "code=last_provided_code (" . t('Required') . ") 
";
    echo '
' . t('This will return brut text content.') . ' ' .
         t('Returns the next code to use.') . '
';
    echo t('Send a GET query to') . ': ' . $web_root . 'script.php?end_async
';
    echo '
';
    echo t('Parameters') . ':
';
    echo "ref=async_reference (" . t('Required') . ") 
";
    echo "code=last_provided_code (" . t('Required') . ") 
";
    echo '
' . t('This will return brut text content.') . ' ' .
         t('First line is the download reference and the second line the delete code.') . '
'; echo t('This interface permits to create a block of data filled with zeros.') . ' ' . t('You can read selected parts, write (using a code) and delete the block.') . ' ' . t('Blocks may be removed after a month of non usage.'); echo '
'; echo '';
        echo t('Send a GET query to') . ': ' . $web_root . 'script.php?init_block
';
        echo '
';
        echo t('Parameters') . ':
';
        echo "size=size_in_bytes (" . t('Required') . ") 
";
        echo '
' . t('This will return brut text content.') . ' ' .
             t('First line is a block id the second line the edit/delete code.') . '
';
        echo t('Send a GET query to') . ': ' . $web_root . 'script.php?read_block
';
        echo '
';
        echo t('Parameters') . ':
';
        echo "id=block_id (" . t('Required') . ") 
";
        echo "start=byte_position_starting_from_zero (" . t('Required') . ") 
";
        echo "length=length_to_read_in_bytes (" . t('Required') . ") 
";
        echo '
' . t('This will return asked data or "Error" string.') . '
';
        echo t('Send a GET query to') . ': ' . $web_root . 'script.php?write_block
';
        echo '
';
        echo t('Parameters') . ':
';
        echo "id=block_id (" . t('Required') . ") 
";
        echo "code=block_code (" . t('Required') . ") 
";
        echo "start=byte_position_starting_from_zero (" . t('Required') . ") 
";
        echo "data=data_to_write (" . t('Required') . ") 
";
        echo '
' . t('This will return "Ok" or "Error" string.') . '
';
        echo t('Send a GET query to') . ': ' . $web_root . 'script.php?delete_block
';
        echo '
';
        echo t('Parameters') . ':
';
        echo "id=block_id (" . t('Required') . ") 
";
        echo "code=block_code (" . t('Required') . ") 
";
        echo '
' . t('This will return "Ok" or "Error" string.') . '