@@ -143,6 +143,20 @@ custom table. Only one custom table load can be performed in a Vty
143143program. Once a custom table has been loaded, it cannot be replaced or
144144removed.
145145
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:
149+
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
154+ configuration.
155+
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.
159+
146160# Contributing
147161
148162If you decide to contribute, that's great! Here are some guidelines you