Changeset View
Changeset View
Standalone View
Standalone View
documentation/content/en/articles/committers-guide/_index.adoc
| Show First 20 Lines • Show All 3,665 Lines • ▼ Show 20 Lines | |||||||||
| == Ports Specific FAQ | == Ports Specific FAQ | ||||||||
| [[ports-qa-adding]] | [[ports-qa-adding]] | ||||||||
| === Adding a New Port | === Adding a New Port | ||||||||
| [[ports-qa-add-new]] | [[ports-qa-add-new]] | ||||||||
| ==== How do I add a new port? | ==== How do I add a new port? | ||||||||
| Adding a port to the tree is relatively simple. Once the port is ready to be added, as explained later <<ports-qa-add-new-extra,here>>, you need to add the port's directory entry in the category's [.filename]#Makefile#. In this [.filename]#Makefile#, ports are listed in alphabetical order and added to the SUBDIR variable, like this: | Adding a port to the tree is relatively simple. Once the port is ready to be added, as explained later <<ports-qa-add-new-extra,here>>, you need to add the port's directory entry in the category's [.filename]#Makefile#. In this [.filename]#Makefile#, ports are listed in alphabetical order and added to the SUBDIR variable, like this: | ||||||||
0mpUnsubmitted Done Inline Actions
0mp: 1. Please keep one sentence per line.
2. Use backticks around SUBDIR. | |||||||||
| [.programlisting] | [.programlisting] | ||||||||
| .... | .... | ||||||||
| SUBDIR += newport | SUBDIR += newport | ||||||||
| .... | .... | ||||||||
| Once the port and its category's Makefile are ready, the new port can be committed: | Once the port and its category's Makefile are ready, the new port can be committed: | ||||||||
| [source,shell] | [source,shell] | ||||||||
| .... | .... | ||||||||
| % git add category/Makefile category/newport | % git add category/Makefile category/newport | ||||||||
| % git commit | % git commit | ||||||||
| % git push | % git push | ||||||||
| .... | .... | ||||||||
| [TIP] | [TIP] | ||||||||
| ==== | ==== | ||||||||
| Don't forget to setup git hooks for the ports tree, as explained <<port-commit-message-formats,here>>, a specific hook has been developed to verify the category's [.filename]#Makefile# | Don't forget to <<port-commit-message-formats,setup git hooks for the ports tree as explained here>>; a specific hook has been developed to verify the category's [.filename]#Makefile# | ||||||||
Done Inline Actions
pauamma_gundo.com: https://webaim.org/techniques/hypertext/#alpha_links | |||||||||
Done Inline ActionsMissing dot at the end. 0mp: Missing dot at the end. | |||||||||
| ==== | ==== | ||||||||
| [[ports-qa-add-new-extra]] | [[ports-qa-add-new-extra]] | ||||||||
| ==== Any other things I need to know when I add a new port? | ==== Any other things I need to know when I add a new port? | ||||||||
| Check the port, preferably to make sure it compiles and packages correctly. | Check the port, preferably to make sure it compiles and packages correctly. | ||||||||
| The extref:{porters-handbook}testing[Porters Handbook's Testing Chapter] contains more detailed instructions. | The extref:{porters-handbook}testing[Porters Handbook's Testing Chapter] contains more detailed instructions. | ||||||||
| ▲ Show 20 Lines • Show All 309 Lines • Show Last 20 Lines | |||||||||