\nameref only shows reference as a red rectangle, no name in it

Question

I'm trying to use \usepackage{hyperref} to reference in the text a section by name. The section to be referenced is

\section{whatever}\label{sec:marker}

However, when I place in the text

\nameref{sec:marker}

I get nothing but a narrow red rectangle without a text in it (I expected the text 'whatever' to appear there). Is there anything else I should do to fix this problem?

Here is a MWE of the problem I have:

\documentclass[onecolumn,twoside]{revtex4}
%\usepackage{float}
%\usepackage{graphicx}
%\usepackage{sansmath}
%\usepackage{amsmath}
%\usepackage{tikz}
%\pdfpagewidth 8.32in
%\pdfpageheight 11in
%\setlength{\topmargin}{-20mm}
%\setlength{\columnsep}{10mm}
%\setlength{\oddsidemargin}{-2mm}
%\setlength{\evensidemargin}{-2mm}
%\setlength{\textwidth}{170mm}
%\usepackage{anttor}
%\bibpunct{(}{)}{;}{s}{,}{,}
%\usepackage{fancyhdr}
%\usepackage{longtable}
%\usepackage{pgothic}
%\usepackage[T1]{fontenc}
%\usepackage{eufrak}
%\usepackage{oldgerm}
%\usepackage[normalem]{ulem}
%\usepackage{cancel}
%\usepackage{wasysym}
\usepackage{hyperref}

\begin{document}

\section*{FirstSection}

In \nameref{sec:marker} it is stated that ...

\section*{SecondSection} \label{sec:marker}

\end{document}

Answer 1

Yes, revtex4 plays some tricks on hyperref. That is, revtex4 redefines the sectional macros that hyperref is tapping into, leading to the "lost \nameref".

To fix this, you need the xpatch package and patch the correct sectional macros: \@ssect@ltx and \@sect@ltx, each of which are called depending on whether you use the starred variant (or not) of the sectional command.

Here's a minimal working example:

\documentclass{revtex4}% http://ctan.org/pkg/revtex4
\usepackage{xpatch}% http://ctan.org/pkg/xpatch
\makeatletter
\xpatchcmd{\@ssect@ltx}{\@xsect}{\edef\@currentlabelname{#8}\@xsect}{}{}% Patch \<section>*
\xpatchcmd{\@sect@ltx}{\@xsect}{\edef\@currentlabelname{#8}\@xsect}{}{}% Patch \<section>
\makeatother
\usepackage{hyperref}% http://ctan.org/pkg/hyperref
\begin{document}
\section{FirstSection} \label{sec:marker1}
In \nameref{sec:marker2} it is stated that \ldots

\section*{SecondSection} \label{sec:marker2}
You can also see in \nameref{sec:marker1} that \ldots
\end{document}

\nameref relies on the macro \@currentlabelname that contains the title used in the sectional unit. This title is stored in argument #8 with a call to either \@ssect@ltx or \@sect@ltx. So, the patch restores this definition at an appropriate place within the macros.