terminología correcta para la documentación [cerrado]

Question

La documentación a continuación es para un módulo, que ahora ha sido "dado de baja" y lo estoy escribiendo de reemplazo. Antes de escribir la sustitución quiero conseguir mis términos derecha. Sé que los términos son incorrectos en la documentación - que fue hackeado rápidamente por lo que podía dar instrucciones a un universitario que trabaja en el lado del hardware de este proyecto sobre el uso de un programa I'ld hizo. documental completo se puede encontrar aquí para cualquiera que esté interesado (en tanto como ha sido escrito y en nuestro wiki), la página web sólo puede estar disponible para determinadas IP de (depende de su ISP - conexiones a Internet universitarios tienen más probabilidades de trabajo), y el repositorio SVN es privada

.

Así que hay una gran cantidad de términos que están mal. como.
deliminators
cadena con formato de valor que contiene expresiones (ahora podrían estar equivocados, pero es difícil decir)

¿Cuáles son los términos correctos para estos. Y qué otros errores que han hecho

    ==== formatted string containing value expressions ====
    Before I start on actual programs an explanation of:
    "formatted string containing value expressions" and how to encode values in them.

    The ''formatted string containing value expressions'' is at the core of doing low level transmission.
    We know the decimal 65, hex 41, binary 0100 0001, and the ascii character 'A' all have the same binary representation, so to tell which we are using we have a series of deliminators - numbers preceded by: 
    # are decimal 
    $ are Hex 
    @ are binary 
    No deliminator, then ascii. 

    Putting a sign indicator after the deliminator is optional. It is required if you want to send a negative number.

    You may put muliple values in the same string.
    eg: "a#21@1001111$-0F"

    All values in a ''formatted string containing value expressions'' must be in the range -128 to 255 (inclusive) as they must fit in 8bytes (other values will cause an error). Negative numbers have the compliment of 2 representation for their binary form.

    There are some problems with ascii - characters that can't be sent (in future versions this will be fixed by giving ascii a delineator and some more code to make that deliminator work, I think). 
    Characters that can't be sent:
     * The delineator characters: $#@
     * Numbers written immediately after a value that could have contained those digits:
      * 0,1,2,3,4,5,6,7,8,9 for decimal
      * 0,1,2,3,4,5,6,7,8,9,a,b,c,d,e,f,A,B,C,D,E,F for hex
      * 0,1 for binary

Answer 1

Para empezar, deliminator probablemente sería delimitador, a pesar de que notar que su texto tiene tanto delineador y deliminator en ella - quizá deliminator es una combinación especial delimitador / terminador: -)

Sin embargo, un delimitador se utiliza generalmente para separar los campos y por lo general está presente no importa qué. Lo que tienes es un opcional prefijo que dicta el siguiente tipo de campo. Así que probablemente llame que un "prefijo" o "tipo de prefijo" en su lugar.

La "cadena con formato que contiene expresiones de valor" Me acaba de llamar a una "cadena de expresión valor" o "cadena de valor" para cambiar a una forma más corta.

Otro posible problema:

  

debe estar en entre -128 a 255 (inclusive), ya que deben encajar en 8 bytes

Creo que te refieres 8 los bits .

Answer 2

Trate algo como lo siguiente:

     ==== Value string encoding  ====
    The value string is at the core of the data used for low level
    transmissions.

    Within the value string the following refixes are used:
    # decimal
    $ Hex
    @ binary
    No prefix - ASCII.

    An optional sign may be included after the delimiter for negative numbers.
    Negative numbers are represented using twos complement.

    The value string may contain multiple values:
    eg: "a#21@1001111$-0F"

    All elements of the value string must represent an 8bit value and must
    be in the range -128 to 255

    When using ASCII representation the following characters that can't be sent
     * The delineator characters: $#@ (use prefixed hex value.)
     * Numbers written immediately after a value that could have
       contained those digits:
      * 0,1,2,3,4,5,6,7,8,9 for decimal
      * 0,1,2,3,4,5,6,7,8,9,a,b,c,d,e,f,A,B,C,D,E,F for hex
      * 0,1 for binary