> While I understand the motivations you describe above, something about > this bothers me. As a tool provider the LLVM developers are trying to > provide small/fast/quick linking tools. The above approach helps with > some of that. However, I'm an LLVM user and a big part of using LLVM is > linking my code with LLVM code. When the LLVM developers opt to make a > .o "library", they're essentially forcing users to take all or nothing.Exactly.> As you mentioned in the case of x86 backend, this may make a lot of > sense. On the other hand, it presumes the developers of LLVM know how > the users want to use LLVM! Say there's a little utility function in > the x86 backend that I want to use but I'm not generating any x86 code?If you're not generating X86 code, don't use the X86 library. :) The idea is that LLVM is broken up into libraries that are already probably already too fine-grained. If you don't need something, just don't link to it...> > Overall, this looks really useful, especially when the dependency > > information is built. Perhaps this should eventually be integrated into > > the programmers manual though? > > Perhaps, but with hypertext, what does "integrated" really mean? :)Well, in the long term we want to switch everything over to docbook, at which point it should just be a matter of doing the equiv of "#include ObjectFiles.html", and we suddenly have a new section in the book... -Chris -- http://llvm.cs.uiuc.edu/ http://www.nondot.org/~sabre/Projects/
On Fri, 2004-02-27 at 07:20, Chris Lattner wrote:> > As you mentioned in the case of x86 backend, this may make a lot of > > sense. On the other hand, it presumes the developers of LLVM know how > > the users want to use LLVM! Say there's a little utility function in > > the x86 backend that I want to use but I'm not generating any x86 code? > > If you're not generating X86 code, don't use the X86 library. :) The > idea is that LLVM is broken up into libraries that are already probably > already too fine-grained. If you don't need something, just don't link to > it...This works as long as the libraries are fine-grained _enough_. They probably are so I'm not going to make an issue out of this because there are bigger fish to fry.> Well, in the long term we want to switch everything over to docbook, at > which point it should just be a matter of doing the equiv of "#include > ObjectFiles.html", and we suddenly have a new section in the book...DocBook is good. I'd rather use that than HTML. There's got to be an HTML to DocBook translator around *somewhere*. Is there a Bugzilla for this work? Need me to work on this or has it already started? Reid. -------------- next part -------------- A non-text attachment was scrubbed... Name: signature.asc Type: application/pgp-signature Size: 189 bytes Desc: This is a digitally signed message part URL: <http://lists.llvm.org/pipermail/llvm-dev/attachments/20040227/a48d3d43/attachment.sig>
On Fri, 27 Feb 2004, Reid Spencer wrote:> This works as long as the libraries are fine-grained _enough_. They > probably are so I'm not going to make an issue out of this because there > are bigger fish to fry.If not, they can always be split up later. :)> > Well, in the long term we want to switch everything over to docbook, at > > which point it should just be a matter of doing the equiv of "#include > > ObjectFiles.html", and we suddenly have a new section in the book... > > DocBook is good. I'd rather use that than HTML. There's got to be an > HTML to DocBook translator around *somewhere*. Is there a Bugzilla for > this work? Need me to work on this or has it already started?The first step (PR120) is to convert all of our documentation to HTML4.01 strict, which Misha has been working on. I think this is getting close to done, but is stalled for the moment as Misha is working on other things. Once that's done, PR121 is for conversion to docbook, which we hope to automate as much as possible. :) If you'd like to help (which we would certainly appreciate), grab one of the documents in the docs/ directory that is not marked 4.01 strict, and hack on it until it is. :) Thanks! -Chris -- http://llvm.cs.uiuc.edu/ http://www.nondot.org/~sabre/Projects/