diff --git a/data-raw/ahs.R b/data-raw/ahs.R
index 1d50890e4b8323eeab614eab0c84cd92d3e19ca6..fd48eb6bb15d7d2a7dcadb76395350f65f311aee 100644
--- a/data-raw/ahs.R
+++ b/data-raw/ahs.R
@@ -9,7 +9,7 @@ str(ahs)
 ## save(ahs, file="../data/ahs.RData")
 
 ##----------------------------------------------------------------------
-## Include in the @examples
+## Include in the @examples.
 
 library(lattice)
 library(latticeExtra)
diff --git a/man/ahs.Rd b/man/ahs.Rd
index 7cb32800493c4d577077f654dad50863d8004854..7f159c406fc11a19c969027f848e65ad5c5ed678 100644
--- a/man/ahs.Rd
+++ b/man/ahs.Rd
@@ -22,41 +22,40 @@ The Australian health survey was used by Bonat and
 
 \itemize{
 
-\item \code{sex} - Factor, two levels (0-Male; 1-Female).
+\item \code{sex} - Factor with levels \code{male} and \code{female}.
 
 \item \code{age} - Respondent's age in years divided by 100.
 
 \item \code{income} - Respondent's annual income in Australian
     dollars divided by 1000.
 
-\item \code{levyplus} - Factor, two levels (1- if respondent is
-    covered by private health insurance fund for private patients in
-    public hospital (with doctor of choice); 0 - otherwise).
+\item \code{levyplus} - Coded factor. If respondent is covered by
+    private health insurance fund for private patients in public
+    hospital with doctor of choice (1) or otherwise (0).
 
-\item \code{freepoor} - Factor, two levels (1 - if respondent is
-    covered by government because low income, recent immigrant,
-    unemployed; 0 - otherwise).
+\item \code{freepoor} - Coded factor. If respondent is covered by
+    government because low income, recent immigrant, unemployed (1)
+    or otherwise (0).
 
-\item \code{freerepa} - Factor, two levels (1 - if respondent is
-    covered free by government because of old-age or disability
-    pension, or because invalid veteran or family of deceased
-    veteran; 0 - otherwise).
+\item \code{freerepa} - Coded factor. If respondent is covered free
+    by government because of old-age or disability pension, or
+    because invalid veteran or family of deceased veteran (1) or
+    otherwise (0).
 
 \item \code{illnes} - Number of illnesses in past 2 weeks, with 5 or
-    more weeks coded as 5.
+    illnesses coded as 5.
 
 \item \code{actdays} - Number of days of reduced activity in the past
     two weeks due to illness or injury.
 
 \item \code{hscore} - Respondent's general health questionnaire score
-    using Goldberg's method; high score indicates poor health.
+    using Goldberg's method. High score indicates poor health.
 
-\item \code{chcond1} - Factor, two levels (1 - if respondent has
-    chronic condition(s) but is not limited in activity; 0 -
-    otherwise).
-
-\item \code{chcond2} - Factor, two levels (1 if respondent has
-    chronic condition(s) and is limited in activity; 0 - otherwise).
+\item \code{chcond} - Factor with three levels. If respondent has
+    chronic condition(s) and is limited in activity (\code{limited}),
+    or if the respondent has chronic condition(s) but is not limited
+    in activity (\code{nonlimited}) or otherwise (\code{otherwise},
+    reference level).
 
 \item \code{Ndoc} - Number of consultations with a doctor or
     specialist (response variable).
@@ -74,9 +73,44 @@ The Australian health survey was used by Bonat and
 \item \code{Nmed} - Total number of prescribed and non prescribed
     medications used in the past two days.
 
-\item \code{id} - Respondent's index.
-
 }
 }
+\examples{
+library(lattice)
+library(latticeExtra)
+
+data(ahs, package="mcglm")
+str(ahs)
+
+xt <- xtabs(~age+sex, data=ahs)
+mosaicplot(xt)
+
+xt <- xtabs(~age+chcond, data=ahs)
+mosaicplot(xt)
+
+useOuterStrips(
+    combineLimits(
+        xyplot(Ndoc+Nndoc+Nadm+Nhosp+Nmed~age|sex,
+               outer=TRUE, data=ahs,
+               jitter.x=TRUE, amount=0.01,
+               type=c("p", "a"),
+               scales=list(y=list(relation="free")),
+               ylab="Number or occurences",
+               xlab="Age (years/100)")
+    )
+)
+
+useOuterStrips(
+    combineLimits(
+        xyplot(Ndoc+Nndoc+Nadm+Nhosp+Nmed~income|sex,
+               outer=TRUE, data=ahs,
+               jitter.x=TRUE, amount=0.01,
+               type=c("p", "a"),
+               scales=list(y=list(relation="free")),
+               ylab="Number or occurences",
+               xlab="Age (years/100)")
+    )
+)
+}
 \keyword{datasets}
 
diff --git a/man/plot.mcglm.Rd b/man/plot.mcglm.Rd
index ebb64e8fd5d3dc830eeba23dd354d56390fe49d7..d0c270b0fb9c0e03734b6a395d982143d9026123 100644
--- a/man/plot.mcglm.Rd
+++ b/man/plot.mcglm.Rd
@@ -2,7 +2,8 @@
 % Please edit documentation in R/mc_S3_methods.R
 \name{plot.mcglm}
 \alias{plot.mcglm}
-\title{Default Multivariate Covariance Generalized Linear models plotting}
+\title{Default Multivariate Covariance Generalized Linear models
+    plotting}
 \usage{
 \method{plot}{mcglm}(x, type = "residuals", ...)
 }