llvm-6502/docs/CommandGuide
Rafael Espindola 250bfb1745 Remove the LLVM specific archive index.
Archive files (.a) can have a symbol table indicating which object
files in them define which symbols. The purpose of this symbol table
is to speed up linking by allowing the linker the read only the .o
files it is actually going to use instead of having to parse every
object's symbol table.

LLVM's archive library currently supports a LLVM specific format for
such table. It is hard to see any value in that now that llvm-ld is
gone:

* System linkers don't use it: GNU ar uses the same plugin as the
linker to create archive files with a regular index. The OS X ar
creates no symbol table for IL files, I assume the linker just parses
all IL files.

* It doesn't interact well with archives having both IL and native objects.

* We probably don't want to be responsible for yet another archive
format variant.

This patch then:

* Removes support for creating and reading such index from lib/Archive.
* Remove llvm-ranlib, since there is nothing left for it to do.

We should in the future add support for regular indexes to llvm-ar for
both native and IL objects. When we do that, llvm-ranlib should be
reimplemented as a symlink to llvm-ar, as it is equivalent to "ar s".

git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@184019 91177308-0d34-0410-b5e6-96231b3b80d8
2013-06-14 23:25:53 +00:00
..
bugpoint.rst
FileCheck.rst Add 'CHECK-DAG' support 2013-05-14 20:34:12 +00:00
index.rst Remove the LLVM specific archive index. 2013-06-14 23:25:53 +00:00
lit.rst Fix incorrect parameter name in LIT docs. 2013-05-30 12:37:52 +00:00
llc.rst Document the -filetype option of llc (PR #12902) 2013-04-22 17:16:35 +00:00
lli.rst Fix a typo. 2013-04-02 20:02:36 +00:00
llvm-ar.rst Remove the LLVM specific archive index. 2013-06-14 23:25:53 +00:00
llvm-as.rst
llvm-bcanalyzer.rst Documentation: use paths relative to document root in links. 2012-12-12 21:16:29 +00:00
llvm-build.rst
llvm-config.rst
llvm-cov.rst Documentation for llvm-cov: reformat 2012-11-29 19:10:21 +00:00
llvm-diff.rst
llvm-dis.rst
llvm-extract.rst
llvm-link.rst Update documentation of llvm-link to reflect recent cleanups. 2013-03-19 16:04:19 +00:00
llvm-nm.rst
llvm-prof.rst
llvm-readobj.rst Teach llvm-readobj to print ELF program headers 2013-04-12 04:07:39 +00:00
llvm-stress.rst Documentation for llvm-stress: reformat 2012-11-29 19:05:55 +00:00
llvm-symbolizer.rst Docs for llvm-symbolizer command-line tool 2013-03-01 07:58:27 +00:00
opt.rst Documentation for opt: reformat 2012-11-29 19:02:50 +00:00
tblgen.rst Documentation: end option description with a period 2013-04-27 16:34:24 +00:00