~michihenning/unity-scopes-api/fix-crossbuild

« back to all changes in this revision

Viewing changes to HACKING

  • Committer: Michi Henning
  • Date: 2016-03-31 23:48:56 UTC
  • mto: (163.75.2 unity-scopes-api)
  • mto: This revision was merged to the branch mainline in revision 670.
  • Revision ID: michi.henning@canonical.com-20160331234856-l10sxsytjfos348c
Use a single version file instead of three separate files for major, minor, and micro.

Show diffs side-by-side

added added

removed removed

Lines of Context:
231
231
The version numbers for the libraries are generated from files
232
232
in the debian directory. (See below for general rules on versioning.)
233
233
There are no version numbers defined in any of the MakeLists.txt files.
234
 
Instead, to change the version number, you must edit the following
 
234
Instead, to change the version numbers, you must edit the following
235
235
files:
236
236
 
237
 
  - VERSION.MAJOR
238
 
  - VERSION.MINOR
239
 
  - VERSION.MICRO
240
 
 
241
 
    Each file contains a single integer representing a portion of the 
242
 
    libunity-scopes version.
243
 
 
244
 
  - QT-VERSION.MAJOR
245
 
  - QT-VERSION.MINOR
246
 
  - QT-VERSION.MICRO
247
 
 
248
 
    The full version number parts for libunity-scopes-qt, one integer per file.
 
237
  - VERSION
 
238
 
 
239
    The full version number for libunity-scopes.
 
240
 
 
241
  - QT-VERSION
 
242
 
 
243
    The full version number parts for libunity-scopes-qt.
249
244
 
250
245
  - *If* the soname changes, you need to add the outdated
251
246
    versions to the "Replaces:" and "Conflicts:" entries
252
247
    in control and control.in. (You need an extra
253
 
    entry for each Vivid and Wily. See bileto_pre_release_hook
254
 
    for the sed scripts that append a line to the stanza
255
 
    if the soname is changed. This also may apply
 
248
    entry for each Vivid and Wily/Xenial andlater. See
 
249
    bileto_pre_release_hook for the sed scripts that append a
 
250
    line to the stanza if the soname is changed. This also may apply
256
251
    if the soname of the Qt library changes, in which case
257
252
    bileto_pre_release_hook needs a corresponding update.
258
253
 
 
254
The version files have the format
 
255
 
 
256
    <major>.<minor>.<micro>
 
257
 
 
258
All three numbers must be present.
 
259
 
259
260
The soversion for each library is derived from the corresponding
260
261
version file so, unless the soversion changes, you don't need to
261
262
do anything special.