diff options
author | Michael Olbrich <m.olbrich@pengutronix.de> | 2015-11-13 16:55:25 +0100 |
---|---|---|
committer | Michael Olbrich <m.olbrich@pengutronix.de> | 2015-12-03 22:37:00 +0100 |
commit | 57fe7eaa17835495b9c5dbdaf9ffcaafaee69b41 (patch) | |
tree | a6afd0bff75288125985c9e9ad47a7ee67ad928f /doc/ref_manual.rst | |
parent | 024f45a723f5a4979d9a5085484f56e82fe2110b (diff) | |
download | ptxdist-57fe7eaa17835495b9c5dbdaf9ffcaafaee69b41.tar.gz ptxdist-57fe7eaa17835495b9c5dbdaf9ffcaafaee69b41.tar.xz |
docs: split parameter documentation into a separate file
Signed-off-by: Michael Olbrich <m.olbrich@pengutronix.de>
Diffstat (limited to 'doc/ref_manual.rst')
-rw-r--r-- | doc/ref_manual.rst | 121 |
1 files changed, 1 insertions, 120 deletions
diff --git a/doc/ref_manual.rst b/doc/ref_manual.rst index 00fdfc5ef..127de7d74 100644 --- a/doc/ref_manual.rst +++ b/doc/ref_manual.rst @@ -931,123 +931,4 @@ PTXdist is a command line tool, which is basicly called as: $ ptxdist <action [args]> [options] -Setup and Project Actions -~~~~~~~~~~~~~~~~~~~~~~~~~ - -``menu`` - this will start a menu front-end to control some of - PTXdist’s features in a menu based convenient way. This menu handles the - actions *menuconfig*, *platformconfig*, *kernel* config, *select*, - *platform*, *boardsetup*, *setup*, *go* and *images*. - -``select <config>`` - this action will select a user land - configuration. This step is only required in projects, where no - ``selected_ptxconfig`` file is present. The <config> argument must point - to a valid user land configuration file. PTXdist provides this feature - to enable the user to maintain more than one user land configuration in - the same project. - -``platform <config>`` - this action will select a platform - configuration. This step is only required in projects, where no - ``selected_platform`` file is present. The <config> argument must point - to a valid platform configuration file. PTXdist provides this feature to - enable the user to maintain more than one platform in one project. - -``setup`` - PTXdist uses some global settings, independent from the - project it is working on. These settings belong to users preferences or - simply some network settings to permit PTXdist to download required - packages. - -``boardsetup`` - PTXdist based projects can provide information to - setup and configure the target automatically. This action let the user - setup the environment specific settings like the network IP address and - so on. - -``projects`` - if the generic projects coming in a separate archive - are installed, this actions lists the projects a user can clone for its - own work. - -``clone <from> <to>`` - this action clones an existing project from - the ``projects`` list into a new directory. The <from>argument must be a - name gotten from ``ptxdist projects`` command, the <to>argument is the - new project (and directory) name, created in the current directory. - -``menuconfig`` - start the menu to configure the project’s root - filesystem. This is in respect to user land only. Its the main menu to - select applications and libraries, the root filesystem of the target - should consist of. - -``menuconfig platform`` - this action starts the menu to configure - platform’s settings. As these are architecture and target specific - settings it configures the toolchain, the kernel and a bootloader (but - no user land components). Due to a project can support more than one - platform, this will configure the currently selected platform. The short - form for this action is ``platformconfig``. - -``menuconfig kernel`` - start the menu to configure the platform’s - kernel. As a project can support more than one platform, this will - configure the currently selected platform. The short form for this - action is ``kernelconfig``. - -``menuconfig barebox`` - this action starts the configure menu for - the selected bootloader. It depends on the platform settings which - bootloader is enabled and to be used as an argument to the - ``menuconfig`` action parameter. Due to a project can support more than - one platform, this will configure the bootloader of the currently - selected platform. - -Build Actions -~~~~~~~~~~~~~ - -``go`` - this action will build all enabled packages in the current - project configurations (platform and user land). It will also rebuild - reconfigured packages if any or build additional packages if they where - enabled meanwhile. If enables this step also builds the kernel and - bootloader image. - -``images`` - most of the time this is the last step to get the - required files and/or images for the target. It creates filesystems or - device images to be used in conjunction with the target’s filesystem - media. The result can be found in the ``images/`` directory of the - project or the platform directory. - -Clean Actions -~~~~~~~~~~~~~ - -``clean`` - the ``clean`` action will remove all generated files - while the last ``go`` run: all build, packages and root filesystem - directories. Only the selected configuration files are left untouched. - This is a way to start a fresh build cycle. - -``clean root`` - this action will only clean the root filesystem - directories. All the build directories are left untouched. Using this - action will re-generate all ipkg/opkg archives from the already built - packages and also the root filesystem directories in the next ``go`` - action. The ``clean root`` and ``go`` action is useful, if the - *targetinstall* stage for all packages should run again. - -``clean <package>`` - this action will only clean the dedicated - <package>. It will remove its build directory and all installed files - from the corresponding sysroot directory. - -``distclean`` - the ``distclean`` action will remove all files that - are not part of the main project. It removes all generated files and - directories like the ``clean`` action and also the created links in any - ``platform`` and/or ``select`` action. - +.. include:: ref_parameter.rst |