aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorAvatar Ciaran McCreesh <ciaran.mccreesh@googlemail.com> 2006-04-20 02:07:20 +0000
committerAvatar Ciaran McCreesh <ciaran.mccreesh@googlemail.com> 2006-04-20 02:07:20 +0000
commit97ad3f693f2fc9905653d0edb5c269a79c7c5493 (patch)
treeb61f9aad62d5057c0088e21d8642969e8ac0acdf
parent6bdd6a584971bb3dbc151720ca60063f8b5e9188 (diff)
downloadpaludis-97ad3f693f2fc9905653d0edb5c269a79c7c5493.tar.gz
paludis-97ad3f693f2fc9905653d0edb5c269a79c7c5493.tar.xz
Last batch of code docs changes for now.
-rw-r--r--doc/doc_main.doxygen7
-rw-r--r--paludis/args/args.cc2
-rw-r--r--paludis/args/args.hh2
-rw-r--r--paludis/args/args_TEST.cc14
-rw-r--r--paludis/args/args_dumper.cc8
-rw-r--r--paludis/args/args_dumper.hh2
-rw-r--r--paludis/args/args_error.cc4
-rw-r--r--paludis/args/args_error.hh7
-rw-r--r--paludis/args/args_group.cc2
-rw-r--r--paludis/args/args_group.hh4
-rw-r--r--paludis/args/args_handler.cc2
-rw-r--r--paludis/args/args_handler.hh6
-rw-r--r--paludis/args/args_option.cc9
-rw-r--r--paludis/args/args_option.hh21
-rw-r--r--paludis/args/args_visitor.cc6
-rw-r--r--paludis/args/args_visitor.hh6
-rw-r--r--paludis/dep_atom.hh34
-rw-r--r--paludis/dep_atom_flattener.hh2
-rw-r--r--paludis/dep_list.hh6
-rw-r--r--paludis/dep_parser.cc5
-rw-r--r--paludis/dep_tag.hh3
-rw-r--r--paludis/ebuild.hh7
-rw-r--r--paludis/environment.cc5
-rw-r--r--paludis/fake_repository.hh7
-rw-r--r--paludis/hashed_containers.cc4
-rw-r--r--paludis/portage_repository.cc14
-rw-r--r--paludis/repository.hh12
-rw-r--r--paludis/syncer.hh3
-rw-r--r--paludis/test_extras.cc2
-rw-r--r--paludis/version_operator.hh3
-rw-r--r--src/command_line.hh3
-rw-r--r--src/install.cc7
-rw-r--r--src/paludis.cc2
33 files changed, 192 insertions, 29 deletions
diff --git a/doc/doc_main.doxygen b/doc/doc_main.doxygen
index 4944e4c..9509034 100644
--- a/doc/doc_main.doxygen
+++ b/doc/doc_main.doxygen
@@ -11,6 +11,9 @@
/** \defgroup grplibpaludisqa Paludis QA library
*/
+/** \defgroup grplibpaludisargs Paludis args library
+ */
+
/** \defgroup grptestcases Test cases
*/
@@ -227,7 +230,7 @@
* \ingroup grplibpaludisutil
*/
-/** \defgroup grplog System
+/** \defgroup grpsystem System
*
* \ingroup grplibpaludisutil
*/
@@ -261,7 +264,7 @@
/** \defgroup grpinstance Instance patterns
*
- * \ingroup grppointers
+ * \ingroup grppatterns
*/
/** \defgroup grppimp Private implementation pattern
diff --git a/paludis/args/args.cc b/paludis/args/args.cc
index 9ddedef..fac59ce 100644
--- a/paludis/args/args.cc
+++ b/paludis/args/args.cc
@@ -22,6 +22,6 @@
/** \file
* Implementation for args.hh .
*
- * \ingroup Args
+ * \ingroup grplibpaludisargs
*/
diff --git a/paludis/args/args.hh b/paludis/args/args.hh
index d25a989..ce54eda 100644
--- a/paludis/args/args.hh
+++ b/paludis/args/args.hh
@@ -23,7 +23,7 @@
/** \file
* Master include file for command line argument handling.
*
- * \ingroup Args
+ * \ingroup grplibpaludisargs
*/
#include <paludis/args/args_error.hh>
diff --git a/paludis/args/args_TEST.cc b/paludis/args/args_TEST.cc
index 750d793..d94c7dd 100644
--- a/paludis/args/args_TEST.cc
+++ b/paludis/args/args_TEST.cc
@@ -28,6 +28,8 @@ using namespace test;
/** \file
* Test cases for paludis::args things.
+ *
+ * \ingroup grptestcases
*/
#ifndef DOXYGEN
@@ -83,6 +85,8 @@ namespace test_cases
{
/**
* \test Simple args tests.
+ *
+ * \ingroup grptestcases
*/
struct ArgsTestSimple : TestCase
{
@@ -115,6 +119,11 @@ namespace test_cases
}
} test_args_simple;
+ /**
+ * \test Missing parameters tests.
+ *
+ * \ingroup grptestcases
+ */
struct ArgsTestNoParam : TestCase
{
ArgsTestNoParam() : TestCase("Missing parameters") { }
@@ -127,6 +136,11 @@ namespace test_cases
}
} test_args_no_param;
+ /**
+ * \test String tests.
+ *
+ * \ingroup grptestcases
+ */
struct ArgsTestStringSet : TestCase
{
ArgsTestStringSet() : TestCase("StringSet") { }
diff --git a/paludis/args/args_dumper.cc b/paludis/args/args_dumper.cc
index fcecd8f..afdc747 100644
--- a/paludis/args/args_dumper.cc
+++ b/paludis/args/args_dumper.cc
@@ -23,6 +23,12 @@
#include <sstream>
+/** \file
+ * Implementation of ArgsDumper.
+ *
+ * \ingroup grplibpaludisargs
+ */
+
using namespace paludis;
using namespace paludis::args;
@@ -45,6 +51,7 @@ void ArgsDumper::visit(const ArgsOption * const a)
_os << " " << a->description() << std::endl;
}
+#ifndef DOXYGEN
#define VISIT(type) void ArgsDumper::visit(const type * const a) \
{ visit(static_cast<const ArgsOption *>(a)); }
@@ -53,6 +60,7 @@ VISIT(StringArg)
VISIT(IntegerArg)
VISIT(AliasArg)
VISIT(StringSetArg)
+#endif
void ArgsDumper::visit(const EnumArg * const a)
{
diff --git a/paludis/args/args_dumper.hh b/paludis/args/args_dumper.hh
index 2f26ebf..34ba0a1 100644
--- a/paludis/args/args_dumper.hh
+++ b/paludis/args/args_dumper.hh
@@ -38,6 +38,8 @@ namespace paludis
/**
* Visitor class. Prints help text appropriate to each command line option.
+ *
+ * \ingroup grplibpaludisargs
*/
class ArgsDumper : public ArgsVisitorTypes::ConstVisitor
{
diff --git a/paludis/args/args_error.cc b/paludis/args/args_error.cc
index e645b20..46aaa0d 100644
--- a/paludis/args/args_error.cc
+++ b/paludis/args/args_error.cc
@@ -22,8 +22,8 @@
/** \file
* Implementation for ArgsError.
*
- * \ingroup Args
- * \ingroup Exception
+ * \ingroup grplibpaludisargs
+ * \ingroup grpexceptions
*/
using namespace paludis::args;
diff --git a/paludis/args/args_error.hh b/paludis/args/args_error.hh
index 0dc70f3..8d8355b 100644
--- a/paludis/args/args_error.hh
+++ b/paludis/args/args_error.hh
@@ -26,8 +26,7 @@
/** \file
* Declaration for ArgsError.
*
- * \ingroup Args
- * \ingroup Exception
+ * \ingroup grplibpaludisargs
*/
namespace paludis
@@ -37,8 +36,8 @@ namespace paludis
/**
* Thrown if an invalid command line argument is provided.
*
- * \ingroup Args
- * \ingroup Exception
+ * \ingroup grplibpaludisargs
+ * \ingroup grpexceptions
*/
class ArgsError : public paludis::Exception
{
diff --git a/paludis/args/args_group.cc b/paludis/args/args_group.cc
index ce68745..593e3e7 100644
--- a/paludis/args/args_group.cc
+++ b/paludis/args/args_group.cc
@@ -22,7 +22,7 @@
/** \file
* Implementation for ArgsGroup.
*
- * \ingroup Args
+ * \ingroup grplibpaludisargs
*/
using namespace paludis::args;
diff --git a/paludis/args/args_group.hh b/paludis/args/args_group.hh
index 428a150..c4d4aa5 100644
--- a/paludis/args/args_group.hh
+++ b/paludis/args/args_group.hh
@@ -27,7 +27,7 @@
/** \file
* Declaration for ArgsGroup.
*
- * \ingroup Args
+ * \ingroup grplibpaludisargs
*/
namespace paludis
@@ -40,7 +40,7 @@ namespace paludis
/**
* Contains a related group of command line arguments.
*
- * \ingroup Args
+ * \ingroup grplibpaludisargs
*/
class ArgsGroup
{
diff --git a/paludis/args/args_handler.cc b/paludis/args/args_handler.cc
index 314584d..a681655 100644
--- a/paludis/args/args_handler.cc
+++ b/paludis/args/args_handler.cc
@@ -25,7 +25,7 @@
/** \file
* Implementation for ArgsHandler.
*
- * \ingroup Args
+ * \ingroup grplibpaludisargs
*/
using namespace paludis::args;
diff --git a/paludis/args/args_handler.hh b/paludis/args/args_handler.hh
index fcc6866..42a5179 100644
--- a/paludis/args/args_handler.hh
+++ b/paludis/args/args_handler.hh
@@ -29,7 +29,7 @@
/** \file
* Declaration for ArgsHandler.
*
- * \ingroup Args
+ * \ingroup grplibpaludisargs
*/
namespace paludis
@@ -39,7 +39,7 @@ namespace paludis
/**
* Handles command line arguments.
*
- * \ingroup Args
+ * \ingroup grplibpaludisargs
*/
class ArgsHandler : private InstantiationPolicy<ArgsHandler, instantiation_method::NonCopyableTag>
{
@@ -120,7 +120,7 @@ namespace paludis
/**
* Output an ArgsHandler to an ostream, for --help output.
*
- * \ingroup Args
+ * \ingroup grplibpaludisargs
*/
std::ostream & operator<< (std::ostream &, const ArgsHandler &);
}
diff --git a/paludis/args/args_option.cc b/paludis/args/args_option.cc
index 256d7e0..1abef9e 100644
--- a/paludis/args/args_option.cc
+++ b/paludis/args/args_option.cc
@@ -23,7 +23,7 @@
/** \file
* Implementation for ArgsOption.
*
- * \ingroup Args
+ * \ingroup grplibpaludisargs
*/
using namespace paludis::args;
@@ -81,15 +81,22 @@ IntegerArg::IntegerArg(ArgsGroup * const group, const std::string& long_name,
namespace
{
+ /**
+ * Is an arg a particular value?
+ *
+ * \ingroup grplibpaludisargs
+ */
struct ArgIs
{
const std::string arg;
+ /// Constructor.
ArgIs(const std::string & a) :
arg(a)
{
}
+ /// Comparator.
bool operator() (const std::pair<std::string, std::string> & p) const
{
return p.first == arg;
diff --git a/paludis/args/args_option.hh b/paludis/args/args_option.hh
index 83f6c31..bce3c86 100644
--- a/paludis/args/args_option.hh
+++ b/paludis/args/args_option.hh
@@ -29,7 +29,7 @@
/** \file
* Declaration for ArgsOption.
*
- * \ingroup Args
+ * \ingroup grplibpaludisargs
*/
namespace paludis
@@ -41,7 +41,7 @@ namespace paludis
/**
* Base class for a command line option.
*
- * \ingroup Args
+ * \ingroup grplibpaludisargs
*/
class ArgsOption : public virtual VisitableInterface<ArgsVisitorTypes>
{
@@ -127,7 +127,7 @@ namespace paludis
* A SwitchArg is an option that can either be specified or not
* specified, and that takes no value (for example, --help).
*
- * \ingroup Args
+ * \ingroup grplibpaludisargs
*/
class SwitchArg : public ArgsOption, public Visitable<SwitchArg, ArgsVisitorTypes>
{
@@ -144,7 +144,7 @@ namespace paludis
/**
* An option that takes a string argument.
*
- * \ingroup Args
+ * \ingroup grplibpaludisargs
*/
class StringArg : public ArgsOption, public Visitable<StringArg, ArgsVisitorTypes>
{
@@ -170,6 +170,11 @@ namespace paludis
void set_argument(const std::string& arg) { _argument = arg; }
};
+ /**
+ * An option that takes a set of strings.
+ *
+ * \ingroup grplibpaludisargs
+ */
class StringSetArg : public ArgsOption, public Visitable<StringSetArg, ArgsVisitorTypes>
{
private:
@@ -208,7 +213,7 @@ namespace paludis
/**
* An AliasArg is an alias for another argument.
*
- * \ingroup Args
+ * \ingroup grplibpaludisargs
*/
class AliasArg : public ArgsOption, public Visitable<AliasArg, ArgsVisitorTypes>
{
@@ -235,7 +240,7 @@ namespace paludis
/**
* An option that takes an integer argument.
*
- * \ingroup Args
+ * \ingroup grplibpaludisargs
*/
class IntegerArg : public ArgsOption, public Visitable<IntegerArg, ArgsVisitorTypes>
{
@@ -262,7 +267,7 @@ namespace paludis
/**
* An option that takes one of a predefined set of string arguments.
*
- * \ingroup Args
+ * \ingroup grplibpaludisargs
*/
class EnumArg : public ArgsOption, public Visitable<EnumArg, ArgsVisitorTypes>
{
@@ -277,7 +282,7 @@ namespace paludis
* Helper class for passing available options and associated descriptions
* to the EnumArg constructor.
*
- * \ingroup Args
+ * \ingroup grplibpaludisargs
*/
class EnumArgOptions
{
diff --git a/paludis/args/args_visitor.cc b/paludis/args/args_visitor.cc
index 1ea34d8..979debd 100644
--- a/paludis/args/args_visitor.cc
+++ b/paludis/args/args_visitor.cc
@@ -25,6 +25,12 @@
#include <sstream>
+/** \file
+ * Implementation for ArgsVisitor.
+ *
+ * \ingroup grplibpaludisargs
+ */
+
using namespace paludis;
using namespace args;
diff --git a/paludis/args/args_visitor.hh b/paludis/args/args_visitor.hh
index 0b4bfa6..17a9eac 100644
--- a/paludis/args/args_visitor.hh
+++ b/paludis/args/args_visitor.hh
@@ -28,7 +28,7 @@
/** \file
* Declaration for ArgsVisitor
*
- * \ingroup Args
+ * \ingroup grplibpaludisargs
*/
namespace paludis
@@ -45,12 +45,16 @@ namespace paludis
/**
* Visitor types for visitors that can visit Args.
+ *
+ * \ingroup grplibpaludisargs
*/
typedef VisitorTypes<ArgsOption *, StringArg *, AliasArg *, SwitchArg *,
IntegerArg *, EnumArg *, StringSetArg *> ArgsVisitorTypes;
/**
* Visitor class. Processes command-line options as they are found.
+ *
+ * \ingroup grplibpaludisargs
*/
class ArgsVisitor : public ArgsVisitorTypes::Visitor
{
diff --git a/paludis/dep_atom.hh b/paludis/dep_atom.hh
index f525436..0255eb1 100644
--- a/paludis/dep_atom.hh
+++ b/paludis/dep_atom.hh
@@ -129,7 +129,14 @@ namespace paludis
return _children.end();
}
+ /**
+ * A non-constant smart pointer to ourself.
+ */
typedef CountedPtr<CompositeDepAtom, count_policy::InternalCountTag> Pointer;
+
+ /**
+ * A constant smart pointer to ourself.
+ */
typedef CountedPtr<const CompositeDepAtom, count_policy::InternalCountTag> ConstPointer;
};
@@ -217,6 +224,9 @@ namespace paludis
const std::string _str;
protected:
+ /**
+ * Constructor.
+ */
StringDepAtom(const std::string &);
public:
@@ -305,7 +315,14 @@ namespace paludis
}
+ /**
+ * A non-constant smart pointer to ourself.
+ */
typedef CountedPtr<PackageDepAtom, count_policy::InternalCountTag> Pointer;
+
+ /**
+ * A constant smart pointer to ourself.
+ */
typedef CountedPtr<const PackageDepAtom, count_policy::InternalCountTag> ConstPointer;
/**
@@ -341,7 +358,14 @@ namespace paludis
*/
PlainTextDepAtom(const std::string &);
+ /**
+ * A non-constant smart pointer to ourself.
+ */
typedef CountedPtr<PlainTextDepAtom, count_policy::InternalCountTag> Pointer;
+
+ /**
+ * A constant smart pointer to ourself.
+ */
typedef CountedPtr<const PlainTextDepAtom, count_policy::InternalCountTag> ConstPointer;
};
@@ -355,6 +379,9 @@ namespace paludis
public Exception
{
public:
+ /**
+ * Constructor.
+ */
PackageDepAtomError(const std::string & msg) throw ();
};
@@ -393,7 +420,14 @@ namespace paludis
return _atom;
}
+ /**
+ * A non-constant smart pointer to ourself.
+ */
typedef CountedPtr<BlockDepAtom, count_policy::InternalCountTag> Pointer;
+
+ /**
+ * A constant smart pointer to ourself.
+ */
typedef CountedPtr<const BlockDepAtom, count_policy::InternalCountTag> ConstPointer;
};
diff --git a/paludis/dep_atom_flattener.hh b/paludis/dep_atom_flattener.hh
index 9cedee3..dd7b20e 100644
--- a/paludis/dep_atom_flattener.hh
+++ b/paludis/dep_atom_flattener.hh
@@ -27,7 +27,7 @@
#include <paludis/util/attributes.hh>
#include <paludis/util/instantiation_policy.hh>
-/**
+/** \file
* Declarations for DepAtomFlattener.
*
* \ingroup grpdepatomflattener
diff --git a/paludis/dep_list.hh b/paludis/dep_list.hh
index 539fdb5..1f6887b 100644
--- a/paludis/dep_list.hh
+++ b/paludis/dep_list.hh
@@ -64,6 +64,9 @@ namespace paludis
last_dlef
};
+ /**
+ * Flags for a DepListEntry.
+ */
typedef std::bitset<last_dlef> DepListEntryFlags;
/**
@@ -154,6 +157,9 @@ namespace paludis
{
}
+ /**
+ * Our query.
+ */
const std::string & query() const
{
return _query;
diff --git a/paludis/dep_parser.cc b/paludis/dep_parser.cc
index 5485dda..3333e5f 100644
--- a/paludis/dep_parser.cc
+++ b/paludis/dep_parser.cc
@@ -45,6 +45,11 @@ DepStringNestingError::DepStringNestingError(const std::string & dep_string) thr
namespace
{
+ /**
+ * Our current state.
+ *
+ * \ingroup grpdepparser
+ */
enum DepParserState
{
dps_initial,
diff --git a/paludis/dep_tag.hh b/paludis/dep_tag.hh
index 5f98cb85..32252e1 100644
--- a/paludis/dep_tag.hh
+++ b/paludis/dep_tag.hh
@@ -109,6 +109,9 @@ namespace paludis
public Exception
{
public:
+ /**
+ * Constructor.
+ */
NoSuchDepTagCategory(const std::string &) throw ();
};
diff --git a/paludis/ebuild.hh b/paludis/ebuild.hh
index a3db0ad..422cd2a 100644
--- a/paludis/ebuild.hh
+++ b/paludis/ebuild.hh
@@ -232,18 +232,21 @@ namespace paludis
/**
* Parameters for EbuildFetchCommand's constructor.
*
- * \ingroup grpebuildinterface.
+ * \ingroup grpebuildinterface
*/
typedef MakeSmartRecord<EbuildFetchCommandParamsTag>::Type EbuildFetchCommandParams;
/**
* An EbuildFetchCommand is used to download and verify the digests for a
* particular ebuild in a PortageRepository. On failure it throws.
+ *
+ * \ingroup grpebuildinterface
*/
class EbuildFetchCommand :
public EbuildCommand
{
protected:
+ /// Parameters for fetch.
const EbuildFetchCommandParams fetch_params;
virtual std::string commands() const;
@@ -319,6 +322,7 @@ namespace paludis
public EbuildCommand
{
protected:
+ /// Parameters for install.
const EbuildInstallCommandParams install_params;
virtual std::string commands() const;
@@ -381,6 +385,7 @@ namespace paludis
public EbuildCommand
{
protected:
+ /// Parameters for uninstall.
const EbuildUninstallCommandParams uninstall_params;
virtual std::string commands() const;
diff --git a/paludis/environment.cc b/paludis/environment.cc
index 5cbf7be..cf59b58 100644
--- a/paludis/environment.cc
+++ b/paludis/environment.cc
@@ -49,8 +49,13 @@ namespace
struct LicenceChecker :
DepAtomVisitorTypes::ConstVisitor
{
+ /// Are all necessary licences ok?
bool ok;
+
+ /// Our environment.
const Environment * const env;
+
+ /// Our package database.
const PackageDatabaseEntry * const db_entry;
/// Constructor
diff --git a/paludis/fake_repository.hh b/paludis/fake_repository.hh
index 7d1b153..5a25aa8 100644
--- a/paludis/fake_repository.hh
+++ b/paludis/fake_repository.hh
@@ -129,7 +129,14 @@ namespace paludis
return add_version(CategoryNamePart(c), PackageNamePart(p), VersionSpec(v));
}
+ /**
+ * A non-constant smart pointer to ourself.
+ */
typedef CountedPtr<FakeRepository, count_policy::InternalCountTag> Pointer;
+
+ /**
+ * A constant smart pointer to ourself.
+ */
typedef CountedPtr<const FakeRepository, count_policy::InternalCountTag> ConstPointer;
virtual bool installed() const
diff --git a/paludis/hashed_containers.cc b/paludis/hashed_containers.cc
index 30f566a..ddee118 100644
--- a/paludis/hashed_containers.cc
+++ b/paludis/hashed_containers.cc
@@ -29,6 +29,8 @@ using namespace paludis;
#if PALUDIS_HAVE_TR1_HASHES || PALUDIS_HAVE_EXT_HASHES || PALUDIS_HAVE_STD_HASHES
+#ifndef DOXYGEN
+
std::size_t
CRCHash<QualifiedPackageName>::operator() (const QualifiedPackageName & val) const
{
@@ -102,3 +104,5 @@ CRCHash<std::pair<QualifiedPackageName, VersionSpec> >::operator() (
#endif
+#endif
+
diff --git a/paludis/portage_repository.cc b/paludis/portage_repository.cc
index 85c47a5..581b2ef 100644
--- a/paludis/portage_repository.cc
+++ b/paludis/portage_repository.cc
@@ -63,26 +63,37 @@ using namespace paludis;
namespace paludis
{
+ /// Map for versions.
typedef MakeHashedMap<QualifiedPackageName, VersionSpecCollection::Pointer>::Type VersionsMap;
+ /// Map for virtuals.
typedef MakeHashedMap<QualifiedPackageName, PackageDepAtom::ConstPointer>::Type VirtualsMap;
+ /// Map for repository masks.
typedef MakeHashedMap<QualifiedPackageName, std::deque<PackageDepAtom::ConstPointer> >::Type RepositoryMaskMap;
+ /// Map for categories.
typedef MakeHashedMap<CategoryNamePart, bool>::Type CategoryMap;
+ /// Map for packages.
typedef MakeHashedMap<QualifiedPackageName, bool>::Type PackagesMap;
+ /// Map for USE flags.
typedef MakeHashedMap<UseFlagName, UseFlagState>::Type UseMap;
+ /// Map for USE masking.
typedef MakeHashedSet<UseFlagName>::Type UseMaskSet;
+ /// Map for USE flag sets.
typedef MakeHashedSet<UseFlagName>::Type UseFlagSet;
+ /// Map for mirrors.
typedef MakeHashedMap<std::string, std::list<std::string> >::Type MirrorMap;
+ /// Map for metadata.
typedef MakeHashedMap<std::pair<QualifiedPackageName, VersionSpec>, VersionMetadata::Pointer>::Type MetadataMap;
+ /// Map for profile environment.
typedef MakeHashedMap<std::string, std::string>::Type ProfileEnvMap;
/**
@@ -471,13 +482,16 @@ namespace
struct CategoryFilter :
std::unary_function<bool, QualifiedPackageName>
{
+ /// Our category.
CategoryNamePart category;
+ /// Constructor.
CategoryFilter(const CategoryNamePart & c) :
category(c)
{
}
+ /// Predicate.
bool operator() (const QualifiedPackageName & a) const
{
return a.get<qpn_category>() == category;
diff --git a/paludis/repository.hh b/paludis/repository.hh
index 319d6e3..6b4d287 100644
--- a/paludis/repository.hh
+++ b/paludis/repository.hh
@@ -520,6 +520,9 @@ namespace paludis
class PackageActionError : public Exception
{
protected:
+ /**
+ * Constructor.
+ */
PackageActionError(const std::string & msg) throw ();
};
@@ -532,6 +535,9 @@ namespace paludis
class PackageInstallActionError : public PackageActionError
{
public:
+ /**
+ * Constructor.
+ */
PackageInstallActionError(const std::string & msg) throw ();
};
@@ -544,6 +550,9 @@ namespace paludis
class PackageFetchActionError : public PackageActionError
{
public:
+ /**
+ * Constructor.
+ */
PackageFetchActionError(const std::string & msg) throw ();
};
@@ -556,6 +565,9 @@ namespace paludis
class PackageUninstallActionError : public PackageActionError
{
public:
+ /**
+ * Constructor.
+ */
PackageUninstallActionError(const std::string & msg) throw ();
};
diff --git a/paludis/syncer.hh b/paludis/syncer.hh
index 2257ac3..f3d7b75 100644
--- a/paludis/syncer.hh
+++ b/paludis/syncer.hh
@@ -106,6 +106,9 @@ namespace paludis
public PackageActionError
{
protected:
+ /**
+ * Constructor.
+ */
SyncFailedError(const std::string & msg) throw ();
public:
diff --git a/paludis/test_extras.cc b/paludis/test_extras.cc
index e7fbac8..ec66d14 100644
--- a/paludis/test_extras.cc
+++ b/paludis/test_extras.cc
@@ -50,8 +50,10 @@ namespace
*/
struct C
{
+ /// Dummy stream.
std::stringstream s;
+ /// Constructor.
C()
{
test::set_exception_to_debug_string(&verbose_exception_to_debug_string);
diff --git a/paludis/version_operator.hh b/paludis/version_operator.hh
index 94d69c1..a91e616 100644
--- a/paludis/version_operator.hh
+++ b/paludis/version_operator.hh
@@ -121,6 +121,9 @@ namespace paludis
public Exception
{
public:
+ /**
+ * Constructor.
+ */
BadVersionOperatorError(const std::string & msg) throw ();
};
diff --git a/src/command_line.hh b/src/command_line.hh
index fb92eeb..d1e4840 100644
--- a/src/command_line.hh
+++ b/src/command_line.hh
@@ -181,6 +181,9 @@ class CommandLine :
/// }
};
+/**
+ * Show the help message.
+ */
struct DoHelp
{
const std::string message;
diff --git a/src/install.cc b/src/install.cc
index 459ee51..6322a97 100644
--- a/src/install.cc
+++ b/src/install.cc
@@ -35,12 +35,19 @@ using std::endl;
namespace
{
+ /**
+ * Display licences.
+ */
struct LicenceDisplayer :
p::DepAtomVisitorTypes::ConstVisitor
{
+ /// Our environment.
const p::Environment * const env;
+
+ /// Our db entry.
const p::PackageDatabaseEntry * const db_entry;
+ /// Constructor.
LicenceDisplayer(const p::Environment * const e, const p::PackageDatabaseEntry * const d) :
env(e),
db_entry(d)
diff --git a/src/paludis.cc b/src/paludis.cc
index 4f483d7..75f038e 100644
--- a/src/paludis.cc
+++ b/src/paludis.cc
@@ -41,9 +41,11 @@ using std::cout;
using std::cerr;
using std::endl;
+#ifndef DOXYGEN
struct DoVersion
{
};
+#endif
int
main(int argc, char *argv[])