Fix doxygen warnings.

[brucem]

Summary

Building the doxygen target presented some warnings which are now
addressed by this patch.

[brucem]

There has been discussion in the past that sometimes the SWIG .i files are generated from these headers, if I remember correctly? Does that matter for this or is this safe to go in?

(SWIG interface files generate a whole lot of problems for running epydoc to extract the Python documentation...)

[clayborg]

Looks good.

include/lldb/API/SBModule.h

public:
     /// to launching.
     ///
     /// If \a file specifies a full path to an install location, the
     /// module will be installed to this path. If the path is relative
     /// (no directory specified, or the path is partial like "usr/lib"
     /// or "./usr/lib", then the install path will be resolved using
     /// the platform's current working directory as the base path.
     ///
-    /// @param[in]
+    /// @param[in] file
     ///     A file specification object.
     //------------------------------------------------------------------
     bool
     SetRemoteInstallFileSpec (lldb::SBFileSpec &file);
     
     lldb::ByteOrder
     GetByteOrder ();
     

include/lldb/API/SBTarget.h

public:
     ///
     /// @param[in] launch_flags
     ///     Some launch options specified by logical OR'ing 
     ///     lldb::LaunchFlags enumeration values together.
     ///
     /// @param[in] stop_at_entry
     ///     If false do not stop the inferior at the entry point.
     ///
-    /// @param[out]
+    /// @param[out] error
     ///     An error object. Contains the reason if there is some failure.
     ///
     /// @return
     ///      A process object for the newly created process.
     //------------------------------------------------------------------
     lldb::SBProcess
     Launch (SBListener &listener, 
             char const **argv,
public:
     ///     An optional listener that will receive all process events.
     ///     If \a listener is valid then \a listener will listen to all
     ///     process events. If not valid, then this target's debugger
     ///     (SBTarget::GetDebugger()) will listen to all process events.
     ///
     /// @param[in] pid
     ///     The process ID to attach to.
     ///
-    /// @param[out]
+    /// @param[out] error
     ///     An error explaining what went wrong if attach fails.
     ///
     /// @return
     ///      A process object for the attached process.
     //------------------------------------------------------------------
     lldb::SBProcess
     AttachToProcessWithID (SBListener &listener,
                            lldb::pid_t pid,
#endif
     ///     (SBTarget::GetDebugger()) will listen to all process events.
     ///
     /// @param[in] name
     ///     Basename of process to attach to.
     ///
     /// @param[in] wait_for
     ///     If true wait for a new instance of 'name' to be launched.
     ///
-    /// @param[out]
+    /// @param[out] error
     ///     An error explaining what went wrong if attach fails.
     ///
     /// @return
     ///      A process object for the attached process.
     //------------------------------------------------------------------
     lldb::SBProcess
     AttachToProcessWithName (SBListener &listener,
                              const char *name,
#endif
     ///     (SBTarget::GetDebugger()) will listen to all process events.
     ///
     /// @param[in] url
     ///     The url to connect to, e.g., 'connect://localhost:12345'.
     ///
     /// @param[in] plugin_name
     ///     The plugin name to be used; can be NULL.
     ///
-    /// @param[out]
+    /// @param[out] error
     ///     An error explaining what went wrong if the connect fails.
     ///
     /// @return
     ///      A process object for the connected process.
     //------------------------------------------------------------------
     lldb::SBProcess
     ConnectRemote (SBListener &listener,
                    const char *url,

include/lldb/API/SBValue.h

#endif
     /// @param[in] idx
     ///     The index of the child value to get
     ///
     /// @param[in] use_dynamic
     ///     An enumeration that specifies whether to get dynamic values,
     ///     and also if the target can be run to figure out the dynamic
     ///     type of the child value.
     ///
-    /// @param[in] synthetic_allowed
+    /// @param[in] can_create_synthetic
     ///     If \b true, then allow child values to be created by index
     ///     for pointers and arrays for indexes that normally wouldn't
     ///     be allowed.
     ///
     /// @return
     ///     A new SBValue object that represents the child member value.
     //------------------------------------------------------------------
     lldb::SBValue
#endif
     ///     though we plan to support it in the future.
     ///
     /// @param[in] read
     ///     Stop when this value is accessed.
     ///
     /// @param[in] write
     ///     Stop when this value is modified
     ///
-    /// @param[out]
+    /// @param[out] error
     ///     An error object. Contains the reason if there is some failure.
     ///
     /// @return
     ///     An SBWatchpoint object. This object might not be valid upon
     ///     return due to a value not being contained in memory, too 
     ///     large, or watchpoint resources are not available or all in
     ///     use.
     //------------------------------------------------------------------
#endif
     ///     though we plan to support it in the future.
     ///
     /// @param[in] read
     ///     Stop when this value is accessed.
     ///
     /// @param[in] write
     ///     Stop when this value is modified
     ///
-    /// @param[out]
+    /// @param[out] error
     ///     An error object. Contains the reason if there is some failure.
     ///
     /// @return
     ///     An SBWatchpoint object. This object might not be valid upon
     ///     return due to a value not being contained in memory, too 
     ///     large, or watchpoint resources are not available or all in
     ///     use.
     //------------------------------------------------------------------