https://bugs.documentfoundation.org/show_bug.cgi?id=130978
Bug ID: 130978
Summary: Add a comment to each published API marking it as such
Product: LibreOffice
Version: unspecified
Hardware: All
OS: All
Status: UNCONFIRMED
Keywords: difficultyBeginner, easyHack, skillCpp, topicCleanup
Severity: enhancement
Priority: medium
Component: LibreOffice
Assignee: libreoffice-bugs@lists.freedesktop.org
Reporter: mikekagan...@hotmail.com
CC: sberg...@redhat.com
A subset of LibreOffice source headers defines different parts of LibreOffice
published API. It would be good to have a standardized comment after the
license statement of those headers unambiguously mentioning that fact, so that
a developer could see immediately if this is part of published API or not. This
is required to clearly see what can be changed and what can't, or needs special
treatment, including public announcement of deprecation, using conditional
compilation for internal vs external usage, etc.
The task is: come up with a suggested comment and document it in README.md;
identify the published subset (communicating with developers in IRC and mailing
list); add the comment to all files in the subset.
--
You are receiving this mail because:
You are the assignee for the bug.
_______________________________________________
Libreoffice-bugs mailing list
Libreoffice-bugs@lists.freedesktop.org
https://lists.freedesktop.org/mailman/listinfo/libreoffice-bugs