@@ -143,6 +143,20 @@ custom table. Only one custom table load can be performed in a Vty
143program. Once a custom table has been loaded, it cannot be replaced or
143program. Once a custom table has been loaded, it cannot be replaced or
146+Without using a custom width table, users of Vty-based applications
147+are likely to eventually experience rendering problems with with wide
148+characters. We recommend that developers of Vty-based applications either:
150+* Provide the `vty-build-width-table` tool and documentation for running
151+ it and updating the Vty configuration, or
152+* Have the application invoke the Vty library's table-building
153+ functionality and load the table at startup without using the Vty
156+The best option will depend on a number of factors: the user audience,
157+the amount of risk posed by wide character rendering, the terminal
158+emulators in use, etc.
146# Contributing
160# Contributing
148If you decide to contribute, that's great! Here are some guidelines you
162If you decide to contribute, that's great! Here are some guidelines you