creator-projects-autotools.qdoc 3.13 KB
Newer Older
1 2
/**************************************************************************
**
3
** Copyright (C) 2010-2013 Openismus GmbH.
hjk's avatar
hjk committed
4 5 6
** Authors: Peter Penz (ppenz@openismus.com)
**          Patricia Santana Cruz (patriciasantanacruz@gmail.com)
** Contact: http://www.qt-project.org/legal
7
**
hjk's avatar
hjk committed
8
** This file is part of Qt Creator.
9
**
hjk's avatar
hjk committed
10 11 12 13 14 15 16
** Commercial License Usage
** Licensees holding valid commercial Qt licenses may use this file in
** accordance with the commercial license agreement provided with the
** Software or, alternatively, in accordance with the terms contained in
** a written agreement between you and Digia.  For licensing terms and
** conditions see http://qt.digia.com/licensing.  For further information
** use the contact form at http://qt.digia.com/contact-us.
17 18
**
** GNU Lesser General Public License Usage
hjk's avatar
hjk committed
19 20 21 22 23 24 25 26 27
** Alternatively, this file may be used under the terms of the GNU Lesser
** General Public License version 2.1 as published by the Free Software
** Foundation and appearing in the file LICENSE.LGPL included in the
** packaging of this file.  Please review the following information to
** ensure the GNU Lesser General Public License version 2.1 requirements
** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.
**
** In addition, as a special exception, Digia gives you certain additional
** rights.  These rights are described in the Digia Qt LGPL Exception
28 29
** version 1.1, included in the file LGPL_EXCEPTION.txt in this package.
**
hjk's avatar
hjk committed
30 31
****************************************************************************/

32 33 34 35 36 37 38 39

/*!
    \contentspage index.html
    \previouspage creator-project-cmake.html
    \page creator-projects-autotools.html
    \nextpage creator-project-generic.html

    \title Setting Up an Autotools Project
40 41 42
    The AutotoolsProjectManager is a plugin for autotools support. It is disabled by default.
    To enable the plugin, select \gui{Help > About Plugins > Build Systems > AutotoolsProjectManager}.
    To use the plugin, restart \QC.
43 44 45 46 47 48

    To work with your Autotools project in \QC:

        \list 1

            \o Select \gui{File > Open File or Project}.
49 50 51 52
            \o Select the Makefile.am file from your project. This is the only
               way you can use the autotools plugin.
            \o Select the build directory. Only in-source building is currently
               supported.
53 54 55 56
            \o Select \gui Finish.
               \QC displays the project tree structure. The root node displays
               the project name. All project files are listed below it and you
               can open them from the list.
57 58 59 60 61 62 63 64 65 66

               \image qtcreator-autotools-buildrun.png

            \o Select \gui Run to build and run the application. The predefined
               build steps (autogen.sh or autoreconf, configure, and make) are
               executed.

               The first time you run the application you must choose the
               executable.

67
            \o To check and edit autotools build steps, select
68 69 70 71 72
               \gui{Projects > Build Settings}.

               You can add parameters to the predefined autotools build steps.

              \image qtcreator-autotools-buildsettings.png
73 74
        \endlist
*/