File: HACKING

package info (click to toggle)
npth 1.6-1
  • links: PTS, VCS
  • area: main
  • in suites: bullseye, buster, sid
  • size: 1,776 kB
  • sloc: sh: 11,858; ansic: 2,333; makefile: 143
file content (23 lines) | stat: -rw-r--r-- 1,024 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
# HACKING                                                       -*- org -*-
#+TITLE: Hacking notes for nPth
#+STARTUP: showall

* No ChangeLog files

  Do not write ChangeLog files for NPTH.  We put change information
  only in the GIT commit log, and generate a top-level ChangeLog file
  from logs at "make dist" time.  As such, there are strict
  requirements on the form of the commit log messages.


* Commit log requirements

  Your commit log should always start with a one-line summary, the
  second line should be blank, and the remaining lines are usually
  ChangeLog-style entries for all affected files.  However, it's fine
  -- even recommended -- to write a few lines of prose describing the
  change, when the summary and ChangeLog entries don't give enough of
  the big picture.  Omit the leading TABs that you're used to seeing
  in a "real" ChangeLog file, but keep the maximum line length at 72
  or smaller, so that the generated ChangeLog lines, each with its
  leading TAB, will not exceed 80 columns.