Doxygenified Argument.h and performed some copy editing of the documentation.

git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@172960 91177308-0d34-0410-b5e6-96231b3b80d8

include/llvm/IR/Argument.h

@@ -24,11 +24,14 @@ namespace llvm {
 template<typename ValueSubClass, typename ItemParentClass>
   class SymbolTableListTraits;
 
-/// A class to represent an incoming formal argument to a Function. An argument
+/// \brief LLVM Argument representation
-/// is a very simple Value. It is essentially a named (optional) type. When used
+///
-/// in the body of a function, it represents the value of the actual argument
+/// This class represents an incoming formal argument to a Function. A formal
-/// the function was called with.
+/// argument, since it is ``formal'', does not contain an actual value but
-/// @brief LLVM Argument representation  
+/// instead represents the type, argument number, and attributes of an argument
+/// for a specific function. When used in the body of said function, the
+/// argument of course represents the value of the actual argument that the
+/// function was called with.
 class Argument : public Value, public ilist_node<Argument> {
   virtual void anchor();
   Function *Parent;
@@ -37,50 +40,52 @@ class Argument : public Value, public ilist_node<Argument> {
   void setParent(Function *parent);
 
 public:
-  /// Argument ctor - If Function argument is specified, this argument is
+  /// \brief Constructor.
-  /// inserted at the end of the argument list for the function.
   ///
+  /// If \p F is specified, the argument is inserted at the end of the argument
+  /// list for \p F.
   explicit Argument(Type *Ty, const Twine &Name = "", Function *F = 0);
 
   inline const Function *getParent() const { return Parent; }
   inline       Function *getParent()       { return Parent; }
 
-  /// getArgNo - Return the index of this formal argument in its containing
+  /// \brief Return the index of this formal argument in its containing
-  /// function.  For example in "void foo(int a, float b)" a is 0 and b is 1. 
+  /// function.
+  ///
+  /// For example in "void foo(int a, float b)" a is 0 and b is 1.
   unsigned getArgNo() const;
 
-  /// hasByValAttr - Return true if this argument has the byval attribute on it
+  /// \brief Return true if this argument has the byval attribute on it in its
-  /// in its containing function.
+  /// containing function.
   bool hasByValAttr() const;
 
-  /// getParamAlignment - If this is a byval argument, return its alignment.
+  /// \brief If this is a byval argument, return its alignment.
   unsigned getParamAlignment() const;
 
-  /// hasNestAttr - Return true if this argument has the nest attribute on
+  /// \brief Return true if this argument has the nest attribute on it in its
-  /// it in its containing function.
+  /// containing function.
   bool hasNestAttr() const;
 
-  /// hasNoAliasAttr - Return true if this argument has the noalias attribute on
+  /// \brief Return true if this argument has the noalias attribute on it in its
-  /// it in its containing function.
+  /// containing function.
   bool hasNoAliasAttr() const;
 
-  /// hasNoCaptureAttr - Return true if this argument has the nocapture
+  /// \brief Return true if this argument has the nocapture attribute on it in
-  /// attribute on it in its containing function.
+  /// its containing function.
   bool hasNoCaptureAttr() const;
 
-  /// hasStructRetAttr - Return true if this argument has the sret attribute on
+  /// \brief Return true if this argument has the sret attribute on it in its
-  /// it in its containing function.
+  /// containing function.
   bool hasStructRetAttr() const;
 
-  /// addAttr - Add a Attribute to an argument
+  /// \brief Add a Attribute to an argument.
   void addAttr(Attribute);
 
-  /// removeAttr - Remove a Attribute from an argument
+  /// \brief Remove a Attribute from an argument.
   void removeAttr(Attribute);
 
-  /// classof - Methods for support type inquiry through isa, cast, and
+  /// \brief Method for support type inquiry through isa, cast, and
-  /// dyn_cast:
+  /// dyn_cast.
-  ///
   static inline bool classof(const Value *V) {
     return V->getValueID() == ArgumentVal;
   }