I'm trying to create a documentation listing similar to that used by MSDN. Here was my first attempt at that:
\subsubsection{User Default Page URL}
\begin{description}
\item[Rationale] This is the default page displayed to a user when
(s)he opens a new window or tab in Microsoft's Internet Explorer browser.
\item[Data Sources] \begin{verbatim}
[HKEY_CURRENT_USER\Software\Microsoft\Internet Explorer]
"Default_Page_URL"="${url}"
\end{verbatim}
\item[Log Format] \begin{verbatim}
uDefaultPageUrl=${url}
\end{verbatim}
\item[Description] The variable \var{url} is escaped using the URL
escaping scheme defined in \ref{urlescape}.
\end{description}
Which produces:
Of course, this is wrong behavior — the registry key bit needs to go on it's own, not pushed over to the right on the first line. I tried following the instructions on this question, which left this:
\subsubsection{User Default Page URL}
\begin{description}
\item[Rationale] \hfill \\ This is the default page displayed to a user when
(s)he opens a new window or tab in Microsoft's Internet Explorer browser.
\item[Data Sources] \hfill \\ \begin{verbatim}
[HKEY_CURRENT_USER\Software\Microsoft\Internet Explorer]
"Default_Page_URL"="${url}"
\end{verbatim}
\item[Log Format] \hfill \\ \begin{verbatim}
uDefaultPageUrl=${url}
\end{verbatim}
\item[Description] \hfill \\ The variable \var{url} is escaped using the URL
escaping scheme defined in \ref{urlescape}.
\end{description}
producing:
This is bad because now there's a huge space before the verbatim text. Also, XeTeX decided to complain quite a bit about bad boxes on this one.
I've tried several "massagings" of this — such as removing the explicit newline after the \hline
on Verbatim environments only. That shrinks the space, but not enough — it still looks like a huge gaping hole.
How would one fix this?
EDIT: In response to the comment:
\subsubsection{User Default Page URL}
\begin{description}
\item[Rationale] This is the default page displayed to a user when
(s)he opens a new window or tab in Microsoft's Internet Explorer browser.
\item[Data Sources] \hfill
\begin{verbatim}
[HKEY_CURRENT_USER\Software\Microsoft\Internet Explorer]
"Default_Page_URL"="${url}"
\end{verbatim}
\item[Log Format]
\begin{verbatim}
uDefaultPageUrl=${url}
\end{verbatim}
\item[Description] The variable \var{url} is escaped using the URL
escaping scheme defined in \ref{urlescape}.
\end{description}
produces:
Best Answer
Perhaps there is better method, but it seems that if you eliminate the
\\
and include a\vspace{-\baselineskip}
before theverbatim
environment you get reasonable looking results: