list_create(9F) manpage deserves an introduction section
Manipulating lists can be quirky at times and require special treatment, especially when copying structures containing lists. The list_create(9F) manpage doesn't have a neat introduction or summary section on the data structure and in particular doesn't point out this peculiar copying behavior, which can instead only be deduced from looking at the list source code. Adding a few paragraphs to the beginning of the manpage should help avoid these trivial mistakes.
Updated by Electric Monk about 4 years ago
- Status changed from New to Closed
commit 3bc3cac557dd137eed9013e966a789bd19dd1d0b Author: Saso Kiselkov <email@example.com> Date: 2015-11-05T00:45:16.000Z 6419 list_create(9F) manpage deserves an introduction section Reviewed by: Andrew Stormont <firstname.lastname@example.org> Reviewed by: Josef 'Jeff' Sipek <email@example.com> Approved by: Robert Mustacchi <firstname.lastname@example.org>