Added Markdown to HACKING file
This commit is contained in:
parent
291f70edee
commit
1f68888020
2 changed files with 37 additions and 24 deletions
57
HACKING.md
57
HACKING.md
|
@ -15,41 +15,54 @@ Here are some directions to get you started:
|
|||
Helper script to get some uniformity in the style:
|
||||
$ make style
|
||||
|
||||
If you use vim see the "Vim: How to prevent trailing whitespaces"
|
||||
http://www.carbon-project.org/Vim__How_to_prevent_trailing_whitespaces.html
|
||||
If you use vim see the [Vim: How to prevent trailing whitespaces](http://www.carbon-project.org/Vim__How_to_prevent_trailing_whitespaces.html).
|
||||
|
||||
2. Chase warnings: no warning should be introduced by your changes
|
||||
Depending what you touch, you can check with:
|
||||
|
||||
2.1 When using autotools
|
||||
$ autoreconf -Wall -vis
|
||||
|
||||
$ autoreconf -Wall -vis
|
||||
|
||||
2.2 When compiling
|
||||
|
||||
2.2.1 Using extra flags:
|
||||
$ export CFLAGS="-Wall -g -O2 -Wextra -pipe -funsigned-char -fstrict-aliasing \
|
||||
-Wchar-subscripts -Wundef -Wshadow -Wcast-align -Wwrite-strings -Wunused \
|
||||
-Wuninitialized -Wpointer-arith -Wredundant-decls -Winline -Wformat \
|
||||
-Wformat-security -Wswitch-enum -Winit-self -Wmissing-include-dirs \
|
||||
-Wmissing-prototypes -Wstrict-prototypes -Wold-style-definition \
|
||||
-Wbad-function-cast -Wnested-externs -Wmissing-declarations"
|
||||
$ ./configure
|
||||
$ make clean
|
||||
$ make
|
||||
|
||||
$ export CFLAGS="-Wall -g -O2 -Wextra -pipe -funsigned-char -fstrict-aliasing \
|
||||
-Wchar-subscripts -Wundef -Wshadow -Wcast-align -Wwrite-strings -Wunused \
|
||||
-Wuninitialized -Wpointer-arith -Wredundant-decls -Winline -Wformat \
|
||||
-Wformat-security -Wswitch-enum -Winit-self -Wmissing-include-dirs \
|
||||
-Wmissing-prototypes -Wstrict-prototypes -Wold-style-definition \
|
||||
-Wbad-function-cast -Wnested-externs -Wmissing-declarations"
|
||||
$ ./configure
|
||||
$ make clean
|
||||
$ make
|
||||
|
||||
2.2.2 Using clang:
|
||||
You can use same CFLAGS but also "-Wunreachable-code"
|
||||
$ scan-build ./configure
|
||||
$ make clean
|
||||
$ scan-build make
|
||||
2.2.3 Using cppcheck (v1.58 or higher):
|
||||
$ make cppcheck
|
||||
|
||||
You can use same CFLAGS but also `-Wunreachable-code`
|
||||
|
||||
$ scan-build ./configure
|
||||
$ make clean
|
||||
$ scan-build make
|
||||
|
||||
2.2.3 Using `cppcheck` (v1.58 or higher):
|
||||
|
||||
$ make cppcheck
|
||||
|
||||
2.3 When Debianizing
|
||||
$ lintian --info --display-info --display-experimental *deb
|
||||
or (shorter version)
|
||||
$ lintian -iIE *deb
|
||||
|
||||
$ lintian --info --display-info --display-experimental *deb
|
||||
or (shorter version)
|
||||
$ lintian -iIE *deb
|
||||
|
||||
3. Preserve cross-platform compatility
|
||||
|
||||
The source code should remain compilable across various platforms,
|
||||
including some you probably cannot test alone so keep it in mind.
|
||||
Supported platforms:
|
||||
|
||||
- Linux
|
||||
- FreeBSD
|
||||
- Mac OS X
|
||||
- Windows with Mingw
|
||||
- Windows with MinGW
|
||||
|
|
|
@ -40,8 +40,8 @@ path, this is optional during installation of CMake):
|
|||
- Now it is possible to run CMake and mingw32-make:
|
||||
|
||||
C:\dev\libnfc-read-only> mkdir ..\libnfc-build
|
||||
C:\dev\libnfc-read-only> cd ..\libnfc-build
|
||||
C:\dev\libnfc-build> cmake-gui .
|
||||
C:\dev\libnfc-read-only> cd ..\libnfc-build
|
||||
C:\dev\libnfc-build> cmake-gui .
|
||||
|
||||
Now you can configure the build. Press "Configure", specify "MinGW32 Makefiles"
|
||||
and then you have the opportunity to set some configuration variables. If you
|
||||
|
|
Loading…
Reference in a new issue