]> git.puffer.fish Git - matthieu/frr.git/commitdiff
quagga: Remove description of deprecated interfaces
authorDonald Sharp <sharpd@cumulusnetworks.com>
Wed, 7 Dec 2016 13:34:39 +0000 (08:34 -0500)
committerDavid Lamparter <equinox@opensourcerouting.org>
Thu, 8 Dec 2016 11:50:25 +0000 (12:50 +0100)
The deprecated interface section is no longer being used.
Let's remove it from the document.

Signed-off-by: Donald Sharp <sharpd@cumulusnetworks.com>
Signed-off-by: David Lamparter <equinox@opensourcerouting.org>
COMMUNITY.md

index cb72ae09df7b8dfa419656f72050023ed98290b8..7d08ed58dc0b290d21bcd1804178ac3b9617f219 100644 (file)
@@ -261,40 +261,6 @@ Please don’t reformat existing files (or only sections modified by your
 changes), even if they don’t follow the standard. This makes it very hard to
 highlight the changes
 
-### Changing / Deprecate an existing exported interface
-
-If changing an exported interface, please try to deprecate the interface in an
-orderly manner. If at all possible, try to retain the old deprecated interface
-as is, or functionally equivalent. Make a note of when the interface was
-deprecated and guard the deprecated interface definitions in the header file,
-i.e.:
-
-```
-/* Deprecated: 20050406 */
-#if !defined(QUAGGA_NO_DEPRECATED_INTERFACES)
-#warning "Using deprecated <libname> (interface(s)|function(s))"
-...
-#endif /* QUAGGA_NO_DEPRECATED_INTERFACES */
-```
-
-This is to ensure that the core Quagga sources do not use the deprecated
-interfaces (you should update Quagga sources to use new interfaces, if
-applicable), while allowing external sources to continue to build. Deprecated
-interfaces should be excised in the next unstable cycle.
-
-Note: If you wish, you can test for GCC and use a function marked with the
-`deprecated` attribute. However, you must provide the warning for other
-compilers.  If changing or removing a command definition, ensure that you
-properly deprecate it - use the `_DEPRECATED` form of the appropriate `DEFUN`
-macro. This is critical. Even if the command can no longer function, you MUST
-still implement it as a do-nothing stub.
-
-Failure to follow this causes grief for systems administrators, as an upgrade
-may cause daemons to fail to start because of unrecognised commands. Deprecated
-commands should be excised in the next unstable cycle. A list of deprecated
-commands should be collated for each release.
-
-
 ### Compile-Time conditional code
 
 Many users access PROJECT via binary packages from 3rd party sources;