2007-07-30 12:28:53 -04:00
|
|
|
GENERAL
|
|
|
|
|
=======
|
|
|
|
|
|
2007-07-25 18:09:53 -04:00
|
|
|
General notes and rules on clutter core hacking;
|
|
|
|
|
|
|
|
|
|
- GNU style indentation, please wrap at 80 chars.
|
|
|
|
|
|
2007-07-30 12:28:53 -04:00
|
|
|
- All non static public API funcs should be documented in the .c via gtk-doc
|
|
|
|
|
|
2007-07-25 18:09:53 -04:00
|
|
|
- All public functions with float parameters should also provide a fixed
|
2007-07-30 12:28:53 -04:00
|
|
|
point version. Fixed point should be used internally.
|
2007-07-25 18:09:53 -04:00
|
|
|
|
|
|
|
|
- Propertys should always be float (never fixed).
|
|
|
|
|
|
|
|
|
|
- API funcs should always use g_return_*
|
|
|
|
|
|
|
|
|
|
- Really try to avoid if possible additions to clutter-private.h
|
|
|
|
|
|
|
|
|
|
- Dont add direct GL calls but wrap with cogl (also adding GL ES Version)
|
|
|
|
|
|
2007-07-30 12:28:53 -04:00
|
|
|
- Use CLUTTER_NOTE() macro for debug statements.
|
|
|
|
|
|
|
|
|
|
- New features should also include an exhaustive test in tests/
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
RELEASES
|
|
|
|
|
========
|
|
|
|
|
|
|
|
|
|
In making a new release;
|
|
|
|
|
|
|
|
|
|
- Check out a fresh copy from SVN.
|
|
|
|
|
|
|
|
|
|
- verify versioning in configure.ac, increasing relevant
|
|
|
|
|
clutter_major_version/clutter_minor_version/clutter_micro_version
|
|
|
|
|
value.
|
|
|
|
|
|
|
|
|
|
- Update NEWS (New feature details, bug #'s), README (Any API changes
|
|
|
|
|
relevant to developers + version), AUTHORS if relevant.
|
|
|
|
|
|
|
|
|
|
- Add a Release entry to the ChangeLog noting version.
|
|
|
|
|
|
|
|
|
|
- make distcheck and fix if fails.
|
|
|
|
|
|
|
|
|
|
- commit.
|
|
|
|
|
|
|
|
|
|
- Make tarballs, upload.
|
|
|
|
|
|
|
|
|
|
- Announce release to waiting world on blog and mailing list.
|
|
|
|
|
|
|
|
|
|
- Release any dependant add-ons following similar rules to above.
|
|
|
|
|
Dont forget to check *.pc file version deps!
|
