similar to: [LLVMdev] LLVM Sphinx intro buried in lld doc?

On Fri, Jun 15, 2012 at 4:44 PM, Mikael Lyngvig <mikael at lyngvig.org> wrote: > Am I the only one who thinks that it is impractical that the Sphinx intro is > buried deep within the lld documentation?  I suggest moving it to the > Programming Documentation document. Agreed that it needs to move to llvm proper, this was always the plan. I think the only thing we were waiting on was

On the other hand, it's the first result on google for "llvm sphinx". --Sean Silva On Fri, Jun 15, 2012 at 4:44 PM, Mikael Lyngvig <mikael at lyngvig.org> wrote: > Am I the only one who thinks that it is impractical that the Sphinx intro > is buried deep within the lld documentation? I suggest moving it to the > Programming Documentation document. > > >

That reminds me: Do the web documents reside in a repository somewhere or should I just grab them using wget? 2012/6/14 Michael Spencer <bigcheesegs at gmail.com> > On Wed, Jun 13, 2012 at 4:02 PM, Mikael Lyngvig <mikael at lyngvig.org> > wrote: > > If nobody else is doing it, I can translate the FAQ into Sphinx as I'd > like > > to begin gradually extending

On Wed, Jun 13, 2012 at 4:47 PM, Mikael Lyngvig <mikael at lyngvig.org> wrote: > That reminds me: Do the web documents reside in a repository somewhere or > should I just grab them using wget? The website is at http://llvm.org/viewvc/llvm-project/www/trunk/ . The llvm docs are in llvm/docs. Which actually makes me wonder if the LLVM-project FAQ (in reference to Chandler's post in

If nobody else is doing it, I can translate the FAQ into Sphinx as I'd like to begin gradually extending it so that it some day becomes more than just bare metal. I figure that extending the FAQ is one way to reduce the "noise" on the various mailing lists. Cheers, Mikael -- -- Love Thy Frog! -------------- next part -------------- An HTML attachment was scrubbed... URL:

On Jun 13, 2012, at 4:47 PM, Mikael Lyngvig wrote: > 2012/6/14 Michael Spencer <bigcheesegs at gmail.com> > On Wed, Jun 13, 2012 at 4:02 PM, Mikael Lyngvig <mikael at lyngvig.org> wrote: > > If nobody else is doing it, I can translate the FAQ into Sphinx as I'd like > > to begin gradually extending it so that it some day becomes more than just > > bare

On Wed, Jun 13, 2012 at 4:02 PM, Mikael Lyngvig <mikael at lyngvig.org> wrote: > If nobody else is doing it, I can translate the FAQ into Sphinx as I'd like > to begin gradually extending it so that it some day becomes more than just > bare metal.  I figure that extending the FAQ is one way to reduce the > "noise" on the various mailing lists. > > > Cheers,

On 3 December 2013 16:08, Mikael Lyngvig <mikael at lyngvig.org> wrote: > You need to get the LLVM Sphinx docs using SVN or Git. If you want it, I > can do the changes for you since I have already everything in place. I think the changes he wants actually are in static html pages, at http://llvm.org/svn/llvm-project/www/trunk. Cheers. Tim.

Hi, The language reference uses "::" many places where it seems it should be using ".. code-block:: llvm". The result is that Sphinx does not colorize these samples. Should I fix this? Or is it purposeful? Also, anybody but me that has noticed that Sphinx does not always colorize things even if you put the proper ".. code-block:: llvm" in front? If it is a known

As I read, I'm writing stuff here things come to me: 1. Don't indent the list. Some of the other RST files do this, but it is incorrect since it indents the list! The list is semantically "at the top level" of indentation (it's not a sub-element of anything). 2. don't have that mini "table of contents" list at the beginning. sphinx will generate that itself

> 8. A Technical Writer FAQ (should include the Sphinx documentation from the lld docs). I'm working on the Sphinx stuff; if you have any questions about writing Sphinx docs feel free to ask. --Sean Silva On Wed, Jun 13, 2012 at 4:37 PM, Mikael Lyngvig <mikael at lyngvig.org> wrote: > I think the best way that I can currently contribute to the project is > through technical

Oh, sorry. Thought everything had been converted to Sphinx. Any particular reason why there are still static pages left on the website? -- Mikael 2013/12/3 Tim Northover <t.p.northover at gmail.com> > On 3 December 2013 16:08, Mikael Lyngvig <mikael at lyngvig.org> wrote: > > You need to get the LLVM Sphinx docs using SVN or Git. If you want it, I > > can do the

Here's the first part of my Windows set up documentation. This one only covers the process of setting up a normal box for building LLVM and Clang. A later document, which will follow in a few days, will cover how to set up a buildbot slave. As usual: I'm not a psychic, so if you have opinions regarding or suggestions on this document, please feel free to share them with me (on this

Done. Do you want to see it again or should I simply ship it off to llvm-commits? The only thing I've changed from the original HTML is that I've changed a few missing code pieces into using code markup. And now I've made the changes you requested and I think it looks really good: Each question being a subsection of its own works very well in my opinon. Oh, heck, I might as well

I just finished up the first draft of the FAQ translated verbatim from HTML to Sphinx. Sphinx did puzzle me a few times but I got used to its approximate error messages and figured out what the problems were. Perhaps you could take a quick glance at this file and tell me if I am doing something wrong? Otherwise I'll send it off to llvm-commits and see what they say. Thanks, Mikael

On Sun, Nov 24, 2013 at 10:19 PM, Mikael Lyngvig <mikael at lyngvig.org> wrote: > Hi, > > The language reference uses "::" many places where it seems it should be > using ".. code-block:: llvm". The result is that Sphinx does not colorize > these samples. > > Should I fix this? Or is it purposeful? > Could you give an example of what you are

On Sun, Nov 17, 2013 at 5:17 AM, Sean Silva <chisophugis at gmail.com> wrote: > > > > On Sun, Nov 17, 2013 at 3:50 AM, Mikael Lyngvig <mikael at lyngvig.org>wrote: > >> It wouldn't take me more than an hour or two to do the format conversion. >> It is rather trivial, actually. Just say the word and I'm on to it like a >> starving bee. I

It wouldn't take me more than an hour or two to do the format conversion. It is rather trivial, actually. Just say the word and I'm on to it like a starving bee. I guess I should get used to using the Sphinx layout; I'm simply more familiar with the format I use on my own websites. Have you guys ever considered making a less formal wiki for LLVM documentation - a place where tiny

On Sun, Nov 17, 2013 at 5:36 AM, Mikael Lyngvig <mikael at lyngvig.org> wrote: > StackOverflows says two things: > > 1. An example is: <meta http-equiv="refresh" content="0; url= > http://example.com/" />. > 2. This apparently discouraged by the WWW Consortium who recommends > server redirects. > > It seems that LLVM.org is served by

On Wed, Jun 13, 2012 at 3:41 PM, Mikael Lyngvig <mikael at lyngvig.org> wrote: > Guys, that was very interesting and useful stuff you preached there. Mind > if I make a patch to the FAQ and include it somewhere? > > "Q: When should I develop against a branch? A: Only if you are making > really big or controversial changes. ... blah blah > > I am thinking that it