Skip to content

Commit ceee04f

Browse files
committed
CONTRIBUTING.md: Set increasing numbers on lists of items
It's easier to read it directly outside the markdown interpretation.
1 parent d6734ad commit ceee04f

File tree

1 file changed

+23
-23
lines changed

1 file changed

+23
-23
lines changed

CONTRIBUTING.md

Lines changed: 23 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -39,34 +39,34 @@ and ask!
3939
1) Check that there isn't a pull request already opened for the changes you
4040
intend to make.
4141

42-
1) [Fork](https://help.github.com/articles/fork-a-repo/) the Tcpdump
42+
2) [Fork](https://help.github.com/articles/fork-a-repo/) the Tcpdump
4343
[repository](https://github.com/the-tcpdump-group/tcpdump).
4444

45-
1) The easiest way to test your changes on multiple operating systems and
45+
3) The easiest way to test your changes on multiple operating systems and
4646
architectures is to let the upstream CI test your pull request (more on
4747
this below).
4848

49-
1) Setup your git working copy
49+
4) Setup your git working copy
5050
```
5151
git clone https://github.com/<username>/tcpdump.git
5252
cd tcpdump
5353
git remote add upstream https://github.com/the-tcpdump-group/tcpdump
5454
git fetch upstream
5555
```
5656

57-
1) Do a `touch .devel` in your working directory.
57+
5) Do a `touch .devel` in your working directory.
5858
Currently, the effect is
5959
* add (via `configure`, in `Makefile`) some warnings options (`-Wall`,
6060
`-Wmissing-prototypes`, `-Wstrict-prototypes`, ...) to the compiler if it
6161
supports these options,
6262
* have the `Makefile` support `make depend` and the `configure` script run it.
6363

64-
1) Configure and build
64+
6) Configure and build
6565
```
6666
./configure && make -s && make check
6767
```
6868

69-
1) Add/update tests
69+
7) Add/update tests
7070
The `tests` directory contains regression tests of the dissection of captured
7171
packets. Those captured packets were saved running tcpdump with option
7272
`-w sample.pcap`. Additional options, such as `-n`, are used to create relevant
@@ -96,30 +96,30 @@ and ask!
9696
It is often useful to have test outputs with different verbosity levels
9797
(none, `-v`, `-vv`, `-vvv`, etc.) depending on the code.
9898

99-
1) Test using `make check` (current build options) and `./build_matrix.sh`
99+
8) Test using `make check` (current build options) and `./build_matrix.sh`
100100
(a multitude of build options, build systems and compilers). If you can,
101101
test on more than one operating system. Don't send a pull request until
102102
all tests pass.
103103

104-
1) Try to rebase your commits to keep the history simple.
104+
9) Try to rebase your commits to keep the history simple.
105105
```
106106
git fetch upstream
107107
git rebase upstream/master
108108
```
109109
(If the rebase fails and you cannot resolve, issue `git rebase --abort`
110110
and ask for help in the pull request comment.)
111111

112-
1) Once 100% happy, put your work into your forked repository using `git push`.
112+
10) Once 100% happy, put your work into your forked repository using `git push`.
113113

114-
1) [Initiate and send](https://help.github.com/articles/using-pull-requests/)
114+
11) [Initiate and send](https://help.github.com/articles/using-pull-requests/)
115115
a pull request.
116116
This will trigger the upstream repository CI tests.
117117

118118

119119
## Code style and generic remarks
120120
1) A thorough reading of some other printers code is useful.
121121

122-
1) To help learn how tcpdump works or to help debugging:
122+
2) To help learn how tcpdump works or to help debugging:
123123
You can configure and build tcpdump with the instrumentation of functions:
124124
```
125125
$ ./configure --enable-instrument-functions
@@ -157,12 +157,12 @@ and ask!
157157

158158
The library libbfd is used, therefore the binutils-dev package is required.
159159

160-
1) Put the normative reference if any as comments (RFC, etc.).
160+
3) Put the normative reference if any as comments (RFC, etc.).
161161

162-
1) Put the format of packets/headers/options as comments if there is no
162+
4) Put the format of packets/headers/options as comments if there is no
163163
published normative reference.
164164

165-
1) The printer may receive incomplete packet in the buffer, truncated at any
165+
5) The printer may receive incomplete packet in the buffer, truncated at any
166166
random position, for example by capturing with `-s size` option.
167167
This means that an attempt to fetch packet data based on the expected
168168
format of the packet may run the risk of overrunning the buffer.
@@ -356,20 +356,20 @@ and ask!
356356
The `nd_*` type for a byte in a sequence of bytes is `nd_byte`; an
357357
*N*-byte sequence should be declared as `nd_byte[N]`.
358358

359-
1) Do invalid packet checks in code: Think that your code can receive in input
359+
7) Do invalid packet checks in code: Think that your code can receive in input
360360
not only a valid packet but any arbitrary random sequence of octets (packet
361361
* built malformed originally by the sender or by a fuzz tester,
362362
* became corrupted in transit or for some other reason).
363363

364364
Print with: `nd_print_invalid(ndo); /* to print " (invalid)" */`
365365

366-
1) Use `struct tok` for indexed strings and print them with
366+
8) Use `struct tok` for indexed strings and print them with
367367
`tok2str()` or `bittok2str()` (for flags).
368368
All `struct tok` must end with `{ 0, NULL }`.
369369

370-
1) Avoid empty lines in output of printers.
370+
9) Avoid empty lines in output of printers.
371371

372-
1) A commit message must have:
372+
10) A commit message must have:
373373
```
374374
First line: Capitalized short summary in the imperative (50 chars or less)
375375
@@ -381,14 +381,14 @@ and ask!
381381
the body.
382382
```
383383

384-
1) Avoid non-ASCII characters in code and commit messages.
384+
11) Avoid non-ASCII characters in code and commit messages.
385385

386-
1) Use the style of the modified sources.
386+
12) Use the style of the modified sources.
387387

388-
1) Don't mix declarations and code.
388+
13) Don't mix declarations and code.
389389

390-
1) tcpdump requires a compiler that supports C99 or later, so C99
390+
14) tcpdump requires a compiler that supports C99 or later, so C99
391391
features may be used in code, but C11 or later features should not be
392392
used.
393393

394-
1) Avoid trailing tabs/spaces
394+
15) Avoid trailing tabs/spaces

0 commit comments

Comments
 (0)