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

Sean Silva silvas at purdue.edu
Thu Sep 27 13:41:46 PDT 2012


This is what I see, on Linux, just now:

sean:~/pg/llvm/llvm/docs % git pull
Already up-to-date.
sean:~/pg/llvm/llvm/docs % file HowToBuildOnARM.rst
HowToBuildOnARM.rst: UTF-8 Unicode English text, with CRLF line terminators
sean:~/pg/llvm/llvm/docs % od -c HowToBuildOnARM.rst | tail
0002220       f   a   i   l   u   r   e   )       p   l   e   a   s   e
0002240       u   s   e       t   h   e       f   o   l   l   o   w   i
0002260   n   g       c   o   n   f   i   g   u   r   a   t   i   o   n
0002300   :  \r  \n  \r  \n               .   .       c   o   d   e   -
0002320   b   l   o   c   k   :   :       b   a   s   h  \r  \n  \r  \n
0002340                       $       .   .   /   $   L   L   V   M   _
0002360   S   R   C   _   D   I   R   /   c   o   n   f   i   g   u   r
0002400   e       -   -   w   i   t   h   -   a   b   i   =   a   a   p
0002420   c   s  \r  \n
0002424

-- Sean Silva

On Thu, Sep 27, 2012 at 4:38 PM, Villmow, Micah <Micah.Villmow at amd.com> wrote:
> Hrmm.... I don't see it on my side.
>
> Micah
>
>> -----Original Message-----
>> From: Sean Silva [mailto:silvas at purdue.edu]
>> Sent: Thursday, September 27, 2012 1:34 PM
>> To: Villmow, Micah
>> Cc: Micah Villmow; llvm-commits at cs.uiuc.edu
>> Subject: Re: [llvm-commits] [llvm] r164776 - in /llvm/trunk/docs:
>> HowToBuildOnARM.rst userguides.rst
>>
>> HowToBuildOnArm.rst also got CRLF'd. Although since it is a new document
>> CRLF doesn't really affect review, it would be good to have it in the
>> "canonical" LF form that everything else is in.
>>
>> --Sean Silva
>>
>> On Thu, Sep 27, 2012 at 1:52 PM, Villmow, Micah <Micah.Villmow at amd.com>
>> wrote:
>> > 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.rs
>> >> >>> t?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
>




More information about the llvm-commits mailing list