Synchronet v3.19b-Win32 (install) has been released (Jan-2022).

You can donate to the Synchronet project using PayPal.

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
Next revisionBoth sides next revision
custom:atcodes [2019/07/09 18:40] – [Terminal Information / Control] Document new Unicode-related @-codes digital mancustom:atcodes [2019/07/10 15:19] – Beautification digital man
Line 23: Line 23:
  
 ^ Modifier ^ Purpose ^ ^ Modifier ^ Purpose ^
-| -L       | Pad and left-justify an expanded @-code | +| ''-L''   | Pad and left-justify an expanded @-code | 
-| -R       | Pad and right-justify an expanded @-code | +| ''-R''   | Pad and right-justify an expanded @-code | 
-| -C       | Pad and center an expanded @-code (added in v3.17b) | +| ''-C''   | Pad and center an expanded @-code (added in v3.17b) | 
-| -Z       | Zero-pad and right-justify an expanded @-code (added in v3.17b) | +| ''-W''   | Displays double-wide using "fullwidth" Unicode code points if possible, spaces between the characters otherwise | 
-| -W       | Allow the terminal to wrap (don't truncate) overly-long expanded @-codes (added in v3.17c) |+| ''-Z''   | Zero-pad and right-justify an expanded @-code (added in v3.17b) | 
 +| ''->''   | Allow the terminal to wrap (don't truncate) overly-long expanded @-codes (added in v3.17c) |
  
 === Width Specificity === === Width Specificity ===
Line 42: Line 43:
  
 When a //width// is specified, expanded @-code strings which are **longer** than the specified width will be truncated (shortened) to adhere to the requested width. The left-most characters are preserved/displayed while the right-most characters are truncated (lost). When a //width// is specified, expanded @-code strings which are **longer** than the specified width will be truncated (shortened) to adhere to the requested width. The left-most characters are preserved/displayed while the right-most characters are truncated (lost).
 +
 +By default, //most// expanded @-codes that would reach the last column of the terminal screen are truncated (shortened) so as to not cause an automatic line-wrap of the user's terminal. If you wish for an expanded @-code to be displayed in the last terminal column, or beyond ( possibly causing an automatic line-wrap of the terminal) use the ''->'' format modifier.
 +
 +=== Exceptions ===
 +@-codes that take an argument value, preceded by a colon ('':'') character cannot be used with format modifiers.
 ===== System Information ===== ===== System Information =====
  
Line 54: Line 60:
 |COPYRIGHT      |                |Synchronet copyright details| |COPYRIGHT      |                |Synchronet copyright details|
 |DATE           |SYSDATE         |Current system date (in "DD/MM/YY" or "MM/DD/YY" format)| |DATE           |SYSDATE         |Current system date (in "DD/MM/YY" or "MM/DD/YY" format)|
 +|DATEFMT        |                |Date display/input format: "DD/MM/YY" or "MM/DD/YY" |
 |DATETIME       |                |Current system date and time (in 24-char long format)| |DATETIME       |                |Current system date and time (in 24-char long format)|
 |DATETIMEZONE   |                |Current system date and time and time-zone | |DATETIMEZONE   |                |Current system date and time and time-zone |
Line 272: Line 279:
 |POFF            |NOPAUSE |Toggle automatic screen pause off | |POFF            |NOPAUSE |Toggle automatic screen pause off |
 |RESETPAUSE      |        |Reset the automatic screen pause line counter | |RESETPAUSE      |        |Reset the automatic screen pause line counter |
-|UP:n            |        |Move cursor up n rows                   | +|UP://n//            |        |Move cursor up //n// rows                   | 
-|DOWN:n          |        |Move cursor down n rows                 | +|DOWN://n//          |        |Move cursor down //n// rows                 | 
-|RIGHT:n         |        |Move cursor right n columns             | +|RIGHT://n//         |        |Move cursor right //n// columns             | 
-|LEFT:n          |        |Move cursor left n columns              | +|LEFT://n//          |        |Move cursor left //n// columns              | 
-|GOTOXY:x,y      |        |Move cursor to x/y coordinate (1-based) |+|GOTOXY://x,y//  |        |Move cursor to //x/////y// coordinate (1-based) |
 |HOME            |        |Home cursor (to upper left), don't clear| |HOME            |        |Home cursor (to upper left), don't clear|
 |CLRLINE         |        |Clear the current line (cursor to first column)| |CLRLINE         |        |Clear the current line (cursor to first column)|
Line 286: Line 293:
 |COLS            |        |Number of terminal columns              | |COLS            |        |Number of terminal columns              |
 |ROWS            |        |Number of terminal rows                 | |ROWS            |        |Number of terminal rows                 |
-|TERM            |        |Terminal-type name                      |+|TERM            |        |Terminal-type name (i.e. 'ANSI', 'RIP', 'PETSCII', or 'DUMB') | 
 +|CHARSET         |        |Terminal character set supported (i.e. 'UTF-8', 'CP437', 'PETSCII', or 'US-ASCII') |
 |WORDWRAP        |        |Word-wrap the the following text        | |WORDWRAP        |        |Word-wrap the the following text        |
 |WRAPOFF         |        |Mark the end of a word-wrapped text block | |WRAPOFF         |        |Mark the end of a word-wrapped text block |
 |CENTER          |        |Middle-align the remaining text on the line | |CENTER          |        |Middle-align the remaining text on the line |
 |SYSONLY         |        |Toggle off/on visibility for non-sysops | |SYSONLY         |        |Toggle off/on visibility for non-sysops |
-|U+<code>        |        |Send a Unicode character code point (in hexadecimal) to UTF-8 terminal or an automatic fallback character, if supported((Not all Unicode code points support fallback characters for ASCII/CP437/PETSCII terminals)) |+|WIDE://text//   |        |Display specified //text// double-wide, using Unicode "fullwidth" characters if possible | 
 +|U+//code//      |        |Send a Unicode character code point (in hexadecimal) to UTF-8 terminal or an automatic fallback character, if supported((Not all Unicode code points support fallback characters for ASCII/CP437/PETSCII terminals)) | 
 +|U+//code/////char// |        | Send a Unicode character code point, specifying fallback character value in hexadecimal (or ''0'' for //none//) | 
 +|U+//code//!//char// |        | Send a Unicode character code point, specifying fallback character only to used when no automatic fallback is available |
  
 ==== Unicode ==== ==== Unicode ====
Line 297: Line 308:
  
 The 'U+' @-code supports additional syntax to allow the sysop to specify the CP437 fallback character: The 'U+' @-code supports additional syntax to allow the sysop to specify the CP437 fallback character:
-  * ''@U+<code>|<char>@'': Send a Unicode character with specified fallback character, in hexadecimal (specify ''0'' to send no character to non-UTF-8 terminals)+  * ''@U+<code>/<char>@'': Send a Unicode character with specified fallback character, in hexadecimal (specify ''0'' to send //no// character to non-UTF-8 terminals)
   * ''@U+<code>!<char>@'': Send a Unicode character with specified fallback character to be used //only// when no automatic fallback character is supported   * ''@U+<code>!<char>@'': Send a Unicode character with specified fallback character to be used //only// when no automatic fallback character is supported
 ===== External Content ===== ===== External Content =====

Trace: