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

Sean Silva silvas at purdue.edu
Thu Sep 27 14:34:44 PDT 2012


If your "VI" was Vim, then the issue is that Vim automagically uses
(and respects) whatever line endings are already in the file.

I would recommend:

sed -i 's/\r//' HowToBuildOnARM.rst

or dos2unix if you have that available.

-- Sean Silva

On Thu, Sep 27, 2012 at 4:48 PM, Villmow, Micah <Micah.Villmow at amd.com> wrote:
> Hrmm, when I try to replace \r in VI with nothing, it doesn't show, but it was showing on the other file.
>
> Micah
>
>> -----Original Message-----
>> From: Sean Silva [mailto:silvas at purdue.edu]
>> Sent: Thursday, September 27, 2012 1:42 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
>>
>> 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