localString returns a structur by value and no pointer.

[kwrtz]

localString returns a structur by value and no pointer. Therefore the example is wrong:

      #define SIZE 40   <--- the LString can never grow longer than 39 chars
      static char buff[SIZE] = "Hello";
      LString *hello = localString(buff, SIZE);
      ...
      lstringchcat(hello, " World !");
    }  <--- automatic deallocation at the end of the scope
 
   Warning: The following does not work (because localString does  
            not allocate memory):
    LString *hello = localString("Hello World", SIZE);  

In my opinion it must be:

      #define SIZE 40   <--- the LString can never grow longer than 39 chars
      static char buff[SIZE] = "Hello";
      LString hello = localString(buff, SIZE);
      ...
      lstringchcat(&hello, " World !");
    }  <--- automatic deallocation at the end of the scope
 
   Warning: The following does not work (because localString does  
            not allocate memory):
    LString hello = localString("Hello World", SIZE);