Changeset 11162

Show
Ignore:
Timestamp:
06/24/09 18:41:20 (9 months ago)
Author:
arvid
Message:

clarified encoding of strings in .torrent files

Files:
1 modified

Legend:

Unmodified
Added
Removed
  • dotorg/trunk/html/beps/bep_0003.rst

    r11031 r11162  
    77Type:    Standard 
    88Created: 10-Jan-2008 
    9 Post-History: 
     9Post-History: 24-Jun-2009, clarified the encoding of strings in torrent files 
    1010 
    1111BitTorrent is a protocol for distributing files. It identifies content 
     
    1717 
    1818A BitTorrent file distribution consists of these entities: 
    19 ------------------------------------------------------------ 
     19---------------------------------------------------------- 
    2020 
    2121- An ordinary web server 
     
    8282  This maps to a dictionary, with keys described below. 
    8383 
    84   The ``name`` key maps to a string which is the suggested name  
    85   to save the file (or directory) as. It is purely advisory. 
     84  The ``name`` key maps to a UTF-8 encoded string which is the 
     85  suggested name to save the file (or directory) as. It is purely advisory. 
    8686 
    8787  ``piece length`` maps to the number of bytes in each piece 
     
    113113  ``length`` - The length of the file, in bytes. 
    114114 
    115   ``path`` - A list of strings corresponding to subdirectory 
     115  ``path`` - A list of UTF-8 encoded strings corresponding to subdirectory 
    116116  names, the last of which is the actual file name (a zero length list 
    117117  is an error case). 
     
    119119  In the single file case, the name key is the name of a file, in the  
    120120  muliple file case, it's the name of a directory. 
     121 
     122  All strings in a .torrent file that contains text must be UTF-8 
     123  encoded. 
     124 
    121125 
    122126Tracker GET requests have the following keys: