User:Dubiousjim/Developer Documentation: Difference between revisions

From Alpine Linux
(saved, WIP)
(saved, WIP)
Line 26: Line 26:
=== Configuring your system ===
=== Configuring your system ===
* [[Upgrading to Edge]] <!-- Pkg and Dev and Installation -->
* [[Upgrading to Edge]] <!-- Pkg and Dev and Installation -->
* [[Setup your system and account for building packages]]
* [[Setup your system and account for building packages]] <!-- included in [[Creating an Alpine package]] -->


<!-- If you edit the following, please coordinate with Installation#Advanced.  Note that these two sections are not exact duplicates. -->
<!-- If you edit the following, please coordinate with Installation#Advanced.  Note that these two sections are not exact duplicates. -->
Line 44: Line 44:
<!-- [[Create an Alpine 1.9 vserver template]] -->
<!-- [[Create an Alpine 1.9 vserver template]] -->


=== Creating packages/building from source ===
=== Building from source/Creating packages ===
 
* [[Aports tree]] <!-- <== APKBUILD -->
* [[Abuild]]
 
* [[Creating an Alpine package]]
* [[Creating an Alpine package]]
* [[Aports tree|Description of the aports tree]]
  <!-- includes [[Setup your system and account for building packages]] -->
* [[APKBUILD]] --> Aports tree
  <!-- includes [[Newapkbuild]]
* [[Abuild]]
      To create the actual APKBUILD file newapkbuild can serve you a template to start with.
      It will create a directory with the given package name, place an example/template APKBUILD
      file to the given directory, and fill some variables if those are provided. -->
** [[Apkbuild-cpan]]
** [[Apkbuild-pypi]]
 
* [[Buildrepo]]
* [[Abuild-keygen]] [[Creating keys for package signing]]
* [[Abuild-sign]]
* [[Abuild-tar]]
* [[Abump]] [[Apkgrel]]
 
* [[Alpine package format]]
* [[Apkindex format]]
* [[Package policies]]
 
* [[APKBUILD Reference]]
* [[APKBUILD examples]]
 
* [[Development using git]] <!-- includes [[Development using git:Configuration]] [[Development using git:Email]] -->
** [[Development using git:Basic usage|Basic usage]]
** [[Package Maintainers]]
** [[Creating patches]]
** [[Development using git:Developer repositories|Developer repositories]]
** [[Development using git:Cgit|Cgit]]
<!--
** [[Migrate SVN to Git]]
-->
 
 
<!--
[[Abuild tree]]


* [[Abuild tree|Description of the abuild tree]]
<pre>
I think this document should be deleted. It does not provide any useful information at all.
I think this document should be deleted. It does not provide any useful information at all.
* You don't need check out abuild from git to be able to build packages. (using an official release of abuild is higly recommended)
* You don't need check out abuild from git to be able to build packages. (using an official release of abuild is higly recommended)
Line 58: Line 91:
* The doc mention nothing about how to use abuild to build packages, not even it mention that you need to do 'make && sudo make install'  
* The doc mention nothing about how to use abuild to build packages, not even it mention that you need to do 'make && sudo make install'  
In short this doc provides no relevant info. I vote for removing it and instead write an how to use abuild doc or similar. --Ncopa 14:45, 6 July 2011 (UTC)  
In short this doc provides no relevant info. I vote for removing it and instead write an how to use abuild doc or similar. --Ncopa 14:45, 6 July 2011 (UTC)  
DJ: should at least be merged into Abuild
----
</pre>
<pre>
The abuild package provides scripts you need when creating packages for Alpine Linux. The abuild and its friends are installed automatically along with the alpine-sdk package.
The abuild package provides scripts you need when creating packages for Alpine Linux. The abuild and its friends are installed automatically along with the alpine-sdk package.
     apk add alpine-sdk
     apk add alpine-sdk
Line 73: Line 104:
{{:Abuild}}
{{:Abuild}}


APKBUILD templates
APKBUILD generation
To create the actual APKBUILD file newapkbuild can serve you a template to start with. It will create a directory with the given package name, place an example/template APKBUILD file to the given directory, and fill some variables if those are provided.
To create the actual APKBUILD file <tt>newapkbuild</tt> can serve you a template to start with. It will create a directory with the given package name, place an example/template APKBUILD file to the given directory, and fill some variables if those are provided.
{{:Newapkbuild}}
{{:Newapkbuild}}
{{:Apkbuild-cpan}}
{{:Apkbuild-cpan}}
{{:Apkbuild-pypi}}
{{:Apkbuild-pypi}}
Line 85: Line 117:
devbuild
devbuild
initramfs-init
initramfs-init
</pre>
* [[Abuild-keygen]]
    Abuild tree (inclusion) (← links)
    Creating an Alpine package (← links)
    Setup your system and account for building packages (← links)
* [[Abuild-sign]]
    Abuild tree (inclusion) (← links)
** [[Creating keys for package signing]]
    Apkindex format (← links)
* [[Abuild-tar]]
    Abuild tree (inclusion) (← links)
* [[Abump]]
    Abuild tree (inclusion) (← links)
* [[Apkgrel]]
    Abuild tree (inclusion) (← links)
* Abuild again
* [[Newapkbuild]]
    Creating an Alpine package (inclusion) (← links)
    Abuild tree (inclusion) (← links)
* [[Apkbuild-cpan]]
    Abuild tree (inclusion) (← links)
* [[Apkbuild-pypi]]
    Abuild tree (inclusion) (← links)
* [[Buildlab]]
    Abuild tree (← links)
* [[Buildrepo]]
    Abuild tree (inclusion) (← links)
* [[Alpine package format]] (no links)
* [[Apkindex format]]
* [[Package policies]]
    Creating an Alpine package (← links)
    Developer Documentation (← links)
* [[Package Maintainers]] (no links)
* [[APKBUILD Reference]]
    Creating an Alpine package (← links)
    Aports tree (← links)
    Developer Documentation (← links)
    Setup your system and account for building packages (← links)
=== Git ===
* [[Development using git]] (Development using git:Configuration) (Development using git:Email)
    Creating patches (← links)
    Creating an Alpine package (← links)
    Developer Documentation (← links)
    Alpine Linux:Contribute (← links)
    Setup your system and account for building packages (← links)
** [[Development using git:Basic usage]]
** [[Creating patches]]
    Development using git (← links)
    Creating an Alpine package (← links)
** [[Development using git:Developer repositories]]
    Development using git (← links)
    Development using git:Cgit (← links)
** [[Development using git:Cgit]]
    Development using git (← links)
    Publish developer repositories on cgit (redirect page) (← links)
<!--
** [[Migrate SVN to Git]]
-->
-->
=== Examples ===
* [[APKBUILD examples]]
    Creating an Alpine package (← links)
    APKBUILD Reference (← links
** [[APKBUILD examples:Simple]]
** [[APKBUILD examples:Subpackages]]
** [[APKBUILD examples:Multiple Subpackages]]
** [[APKBUILD examples:Special Subpackages Doc]]
-test subpackage
** [[APKBUILD examples:Special Subpackages Examples]]
** [[APKBUILD examples:Special Subpackages Languages]]
** [[APKBUILD examples:ACF]]
** [[APKBUILD examples:Perl]]
** [[APKBUILD examples:Php]]
** [[APKBUILD examples:Python]]
** [[APKBUILD examples:Ruby]]
** Lua
** OCaml
** Haskell
** Chicken Scheme


=== Misc ===
=== Misc ===


* [[Alpine Package Testing Suite]] ''Work in progress''
* [[Buildlab]] ''dummy''
* [[Alpine Package Testing Suite]] ''work in progress''
* [[Alpine Release Testing Checklist]]
* [[Alpine Release Testing Checklist]]





Revision as of 23:25, 25 March 2012

This material is work-in-progress ...

Do not follow instructions here until this notice is removed.
(Last edited by Dubiousjim on 25 Mar 2012.)

Package management

Init system


Development

Configuring your system

Building from source/Creating packages


Misc


Alpine Configuration Framework

This material is work-in-progress ...

Needs to be organized/consolidated.
(Last edited by Dubiousjim on 25 Mar 2012.)


Alpine-developed Utilities


Other (shouldn't be in Development?)