[llvm-commits] CVS: llvm/include/llvm/Bytecode/Reader.h

[Reid Spencer]

Changes in directory llvm/include/llvm/Bytecode:

Reader.h updated: 1.17 -> 1.18
---
Log message:

Add a function that gets just the dependent libraries from a bytecode file.
Doxygenify comments.


---
Diffs of the changes:  (+17 -7)

Index: llvm/include/llvm/Bytecode/Reader.h
diff -u llvm/include/llvm/Bytecode/Reader.h:1.17 llvm/include/llvm/Bytecode/Reader.h:1.18
--- llvm/include/llvm/Bytecode/Reader.h:1.17	Tue Jun 29 18:20:03 2004
+++ llvm/include/llvm/Bytecode/Reader.h	Tue Aug 24 17:49:07 2004
@@ -43,21 +43,31 @@
                                                 const std::string &ModuleID="",
 						BytecodeHandler* H = 0);
 
-/// ParseBytecodeFile - Parse the given bytecode file
-///
+/// @brief Parse the given bytecode file
 Module* ParseBytecodeFile(const std::string &Filename,
                           std::string *ErrorStr = 0);
 
-/// ParseBytecodeBuffer - Parse a given bytecode buffer
-///
+/// @brief Parse a given bytecode buffer
 Module* ParseBytecodeBuffer(const unsigned char *Buffer,
                             unsigned BufferSize,
                             const std::string &ModuleID = "",
                             std::string *ErrorStr = 0);
 
-/// ReadArchiveFile - Read bytecode files from the specfied .a file, returning
-/// true on error, or false on success.
-///
+/// This function will read only the necessary parts of a bytecode file in order
+/// to determine the list of dependent libraries encoded within it. The \p
+/// deplibs parameter will contain a vector of strings of the bytecode module's
+/// dependent libraries.
+/// @returns true on success, false otherwise
+/// @brief Get the list of dependent libraries from a bytecode file.
+bool GetBytecodeDependentLibraries(const std::string &fileName, 
+                                   std::vector<std::string>& deplibs);
+
+/// Read bytecode files from the specfied archive (.a) file, convert them
+/// to Module* and provide them in the \p Objects argument. If an error
+/// occurs, ErrorStr (if non-null) will be set to a string explaining
+/// the error.
+/// @return true on error, false on success.
+/// @brief Get a vector of Module* from a bytecode archive file
 bool ReadArchiveFile(const std::string &Filename,
                      std::vector<Module*> &Objects,
                      std::string *ErrorStr = 0);