[llvm-commits] [llvm] r164776 - in /llvm/trunk/docs: HowToBuildOnARM.rst userguides.rst

Thu Sep 27 10:52:54 PDT 2012

r164782.

> -----Original Message-----
> From: llvm-commits-bounces at cs.uiuc.edu [mailto:llvm-commits-
> bounces at cs.uiuc.edu] On Behalf Of Sean Silva
> Sent: Thursday, September 27, 2012 10:19 AM
> To: Micah Villmow
> Cc: llvm-commits at cs.uiuc.edu
> Subject: Re: [llvm-commits] [llvm] r164776 - in /llvm/trunk/docs:
> HowToBuildOnARM.rst userguides.rst
> 
> > hrmm.... is this is an issue with my commit or the tools?
> 
> I don't work on Windows so I don't have much insight into the situation,
> but it looks like your editor changed the line endings and didn't put
> them back how they were.
> 
> Please fix it though. It makes the diff basically impossible to review.
> 
> -- Sean Silva
> 
> On Thu, Sep 27, 2012 at 1:00 PM, Micah Villmow <villmow at gmail.com>
> wrote:
> > hrmm.... is this is an issue with my commit or the tools?
> > On Thu, Sep 27, 2012 at 9:20 AM, Sean Silva <silvas at purdue.edu> wrote:
> >> Ugh, CRLF line endings...
> >>
> >> --Sean Silva
> >>
> >> On Thu, Sep 27, 2012 at 11:05 AM, Micah Villmow <villmow at gmail.com>
> wrote:
> >>> Author: villmow
> >>> Date: Thu Sep 27 10:05:49 2012
> >>> New Revision: 164776
> >>>
> >>> URL: http://llvm.org/viewvc/llvm-project?rev=164776&view=rev
> >>> Log:
> >>> Patch for HowToBuildOnARM documentation from Wei-Ren Chen.
> >>>
> >>> Added:
> >>>     llvm/trunk/docs/HowToBuildOnARM.rst
> >>> Modified:
> >>>     llvm/trunk/docs/userguides.rst
> >>>
> >>> Added: llvm/trunk/docs/HowToBuildOnARM.rst
> >>> URL:
> >>> http://llvm.org/viewvc/llvm-project/llvm/trunk/docs/HowToBuildOnARM.
> >>> rst?rev=164776&view=auto
> >>> ====================================================================
> >>> ==========
> >>> --- llvm/trunk/docs/HowToBuildOnARM.rst (added)
> >>> +++ llvm/trunk/docs/HowToBuildOnARM.rst Thu Sep 27 10:05:49 2012
> >>> @@ -0,0 +1,34 @@
> >>> +.. _how_to_build_on_arm:
> >>> +
> >>> +===================================================================
> >>> +How To Build On ARM
> >>> +===================================================================
> >>> +
> >>> +.. sectionauthor:: Wei-Ren Chen (é™³éŸ‹ä»»)
> >>> +<chenwj at iis.sinica.edu.tw>
> >>> +
> >>> +Introduction
> >>> +============
> >>> +
> >>> +This document contains information about building/testing LLVM and
> >>> +Clang on ARM.
> >>> +
> >>> +Notes On Building LLVM/Clang on ARM
> >>> +=====================================
> >>> +Here are some notes on building/testing LLVM/Clang on ARM. Note
> >>> +that ARM encompasses a wide variety of CPUs; this advice is
> >>> +primarily based on the ARMv6 and ARMv7 architectures and may be
> inapplicable to older chips.
> >>> +
> >>> +#. If you are building LLVM/Clang on an ARM board with 1G of memory
> or less,
> >>> +   please use ``gold`` rather then GNU ``ld``.
> >>> +   Building LLVM/Clang with ``--enable-optimized``
> >>> +   is prefered since it consumes less memory. Otherwise, the
> building
> >>> +   process will very likely fail due to insufficient memory. In any
> >>> +   case it is probably a good idea to set up a swap partition.
> >>> +
> >>> +#. If you want to run ``make
> >>> +   check-all`` after building LLVM/Clang, to avoid false alarms
> (eg, ARCMT
> >>> +   failure) please use the following configuration:
> >>> +
> >>> +   .. code-block:: bash
> >>> +
> >>> +     $ ../$LLVM_SRC_DIR/configure --with-abi=aapcs
> >>>
> >>> Modified: llvm/trunk/docs/userguides.rst
> >>> URL:
> >>> http://llvm.org/viewvc/llvm-project/llvm/trunk/docs/userguides.rst?r
> >>> ev=164776&r1=164775&r2=164776&view=diff
> >>> ====================================================================
> >>> ==========
> >>> --- llvm/trunk/docs/userguides.rst (original)
> >>> +++ llvm/trunk/docs/userguides.rst Thu Sep 27 10:05:49 2012
> >>> @@ -1,92 +1,97 @@
> >>> -.. _userguides:
> >>> -
> >>> -User Guides
> >>> -===========
> >>> -
> >>> -.. toctree::
> >>> -   :hidden:
> >>> -
> >>> -   CMake
> >>> -   CommandGuide/index
> >>> -   DeveloperPolicy
> >>> -   GettingStartedVS
> >>> -   FAQ
> >>> -   Lexicon
> >>> -   Packaging
> >>> -   HowToAddABuilder
> >>> -   yaml2obj
> >>> +.. _userguides:
> >>> +
> >>> +User Guides
> >>> +===========
> >>> +
> >>> +.. toctree::
> >>> +   :hidden:
> >>> +
> >>> +   CMake
> >>> +   HowToBuildOnARM
> >>> +   CommandGuide/index
> >>> +   DeveloperPolicy
> >>> +   GettingStartedVS
> >>> +   FAQ
> >>> +   Lexicon
> >>> +   Packaging
> >>> +   HowToAddABuilder
> >>> +   yaml2obj
> >>>     HowToSubmitABug
> >>> -
> >>> -* `The LLVM Getting Started Guide <GettingStarted.html>`_
> >>> -
> >>> -   Discusses how to get up and running quickly with the LLVM
> infrastructure.
> >>> -   Everything from unpacking and compilation of the distribution to
> execution
> >>> -   of some tools.
> >>> -
> >>> -* :ref:`building-with-cmake`
> >>> -
> >>> -   An addendum to the main Getting Started guide for those using
> the `CMake
> >>> -   build system <http://www.cmake.org>`_.
> >>> -
> >>> -* `Getting Started with the LLVM System using Microsoft Visual
> >>> Studio
> >>> -  <GettingStartedVS.html>`_
> >>> -
> >>> -   An addendum to the main Getting Started guide for those using
> Visual Studio
> >>> -   on Windows.
> >>> -
> >>> -* `LLVM Tutorial <tutorial/>`_
> >>> -
> >>> -   A walk through the process of using LLVM for a custom language,
> and the
> >>> -   facilities LLVM offers in tutorial form.
> >>> -
> >>> -* :ref:`developer_policy`
> >>> -
> >>> -   The LLVM project's policy towards developers and their
> contributions.
> >>> -
> >>> -* :ref:`LLVM Command Guide <commands>`
> >>> -
> >>> -   A reference manual for the LLVM command line utilities ("man"
> pages for LLVM
> >>> -   tools).
> >>> -
> >>> -* `LLVM's Analysis and Transform Passes <Passes.html>`_
> >>> -
> >>> -   A list of optimizations and analyses implemented in LLVM.
> >>> -
> >>> -* :ref:`faq`
> >>> -
> >>> -   A list of common questions and problems and their solutions.
> >>> -
> >>> -* `Release notes for the current release <ReleaseNotes.html>`_
> >>> -
> >>> -   This describes new features, known bugs, and other limitations.
> >>> -
> >>> +
> >>> +* `The LLVM Getting Started Guide <GettingStarted.html>`_
> >>> +
> >>> +   Discusses how to get up and running quickly with the LLVM
> infrastructure.
> >>> +   Everything from unpacking and compilation of the distribution to
> execution
> >>> +   of some tools.
> >>> +
> >>> +* :ref:`building-with-cmake`
> >>> +
> >>> +   An addendum to the main Getting Started guide for those using
> the `CMake
> >>> +   build system <http://www.cmake.org>`_.
> >>> +
> >>> +* :ref:`how_to_build_on_arm`
> >>> +
> >>> +   Notes on building and testing LLVM/Clang on ARM.
> >>> +
> >>> +* `Getting Started with the LLVM System using Microsoft Visual
> >>> +Studio
> >>> +  <GettingStartedVS.html>`_
> >>> +
> >>> +   An addendum to the main Getting Started guide for those using
> Visual Studio
> >>> +   on Windows.
> >>> +
> >>> +* `LLVM Tutorial <tutorial/>`_
> >>> +
> >>> +   A walk through the process of using LLVM for a custom language,
> and the
> >>> +   facilities LLVM offers in tutorial form.
> >>> +
> >>> +* :ref:`developer_policy`
> >>> +
> >>> +   The LLVM project's policy towards developers and their
> contributions.
> >>> +
> >>> +* :ref:`LLVM Command Guide <commands>`
> >>> +
> >>> +   A reference manual for the LLVM command line utilities ("man"
> pages for LLVM
> >>> +   tools).
> >>> +
> >>> +* `LLVM's Analysis and Transform Passes <Passes.html>`_
> >>> +
> >>> +   A list of optimizations and analyses implemented in LLVM.
> >>> +
> >>> +* :ref:`faq`
> >>> +
> >>> +   A list of common questions and problems and their solutions.
> >>> +
> >>> +* `Release notes for the current release <ReleaseNotes.html>`_
> >>> +
> >>> +   This describes new features, known bugs, and other limitations.
> >>> +
> >>>  * :ref:`how-to-submit-a-bug-report`
> >>> -
> >>> -   Instructions for properly submitting information about any bugs
> you run into
> >>> -   in the LLVM system.
> >>> -
> >>> -* `LLVM Testing Infrastructure Guide <TestingGuide.html>`_
> >>> -
> >>> -   A reference manual for using the LLVM testing infrastructure.
> >>> -
> >>> -* `How to build the C, C++, ObjC, and ObjC++ front end
> >>> <http://clang.llvm.org/get_started.html>`_
> >>> -
> >>> -   Instructions for building the clang front-end from source.
> >>> -
> >>> -* :ref:`packaging`
> >>> -
> >>> -   Advice on packaging LLVM into a distribution.
> >>> -
> >>> -* :ref:`lexicon`
> >>> -
> >>> -   Definition of acronyms, terms and concepts used in LLVM.
> >>> -
> >>> -* :ref:`how_to_add_a_builder`
> >>> -
> >>> -   Instructions for adding new builder to LLVM buildbot master.
> >>> -
> >>> -* **IRC** -- You can probably find help on the unofficial LLVM IRC.
> >>> -
> >>> -   We often are on irc.oftc.net in the #llvm channel.  If you are
> using the
> >>> -   mozilla browser, and have chatzilla installed, you can `join
> #llvm on
> >>> -   irc.oftc.net <irc://irc.oftc.net/llvm>`_.
> >>> +
> >>> +   Instructions for properly submitting information about any bugs
> you run into
> >>> +   in the LLVM system.
> >>> +
> >>> +* `LLVM Testing Infrastructure Guide <TestingGuide.html>`_
> >>> +
> >>> +   A reference manual for using the LLVM testing infrastructure.
> >>> +
> >>> +* `How to build the C, C++, ObjC, and ObjC++ front end
> >>> +<http://clang.llvm.org/get_started.html>`_
> >>> +
> >>> +   Instructions for building the clang front-end from source.
> >>> +
> >>> +* :ref:`packaging`
> >>> +
> >>> +   Advice on packaging LLVM into a distribution.
> >>> +
> >>> +* :ref:`lexicon`
> >>> +
> >>> +   Definition of acronyms, terms and concepts used in LLVM.
> >>> +
> >>> +* :ref:`how_to_add_a_builder`
> >>> +
> >>> +   Instructions for adding new builder to LLVM buildbot master.
> >>> +
> >>> +* **IRC** -- You can probably find help on the unofficial LLVM IRC.
> >>> +
> >>> +   We often are on irc.oftc.net in the #llvm channel.  If you are
> using the
> >>> +   mozilla browser, and have chatzilla installed, you can `join
> #llvm on
> >>> +   irc.oftc.net <irc://irc.oftc.net/llvm>`_.
> >>>
> >>>
> >>> _______________________________________________
> >>> llvm-commits mailing list
> >>> llvm-commits at cs.uiuc.edu
> >>> http://lists.cs.uiuc.edu/mailman/listinfo/llvm-commits
> 
> _______________________________________________
> llvm-commits mailing list
> llvm-commits at cs.uiuc.edu
> http://lists.cs.uiuc.edu/mailman/listinfo/llvm-commits