summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/q-and-a/doc/Q-and-A-doc.tex
diff options
context:
space:
mode:
authorNorbert Preining <norbert@preining.info>2023-11-09 03:02:39 +0000
committerNorbert Preining <norbert@preining.info>2023-11-09 03:02:39 +0000
commit3425ad695d75cc781b0fe3412db3aa2ad5985959 (patch)
tree9ec65bca1de4085db47511e67369ea2b71a488fa /macros/latex/contrib/q-and-a/doc/Q-and-A-doc.tex
parentdada699771828d1aa3c78ecf55a2131e5f5799f3 (diff)
CTAN sync 202311090302
Diffstat (limited to 'macros/latex/contrib/q-and-a/doc/Q-and-A-doc.tex')
-rw-r--r--macros/latex/contrib/q-and-a/doc/Q-and-A-doc.tex7
1 files changed, 5 insertions, 2 deletions
diff --git a/macros/latex/contrib/q-and-a/doc/Q-and-A-doc.tex b/macros/latex/contrib/q-and-a/doc/Q-and-A-doc.tex
index 48894878d7..5cdaa152bd 100644
--- a/macros/latex/contrib/q-and-a/doc/Q-and-A-doc.tex
+++ b/macros/latex/contrib/q-and-a/doc/Q-and-A-doc.tex
@@ -5,7 +5,7 @@
scroll,
]{Q-and-A}
-\def\PackageVersion{2023/11/07}
+\def\PackageVersion{2023/11/08}
\def\PackageSubVersion{}
\newcommand{\QApackage}{{\normalfont\textsf{Q-and-A}}}
@@ -247,10 +247,13 @@
\begin{itemize}
\item Currently, the code highlight is done by the package `listings`. Due to its own limitations, the result is still far from satisfactory. Using `minted` instead could improve the situation, but this would require `-shell-escape` and some external tweaking, thus it would still take some effort to make it work with the current document class.
+ \item Due to the current implementation, one cannot direct write code (either inline or displayed) within the text (alternative solution has been proposed above).
+ \item Due to the current implementation, one may not be able to directly write certain characters (such as `\textasterisk`) in the text, this might be especially inconvenient in math mode (temporary alternative solution has been proposed above).
+ \item Due to the current implementation, the method for inputting and including subfiles doesn't really work like `\textbackslash input` and `\textbackslash include`. In particular, the current type of conversation would be reset, this might cause some confusion in certain cases.
% \item The code block containing long piece of code usually won't properly break across the page (which is essentially why this documentation and the demo documents enabled the `scroll` mode).
%% 2023-11-05, solved with the new option "answer outside the box".
\item Due to the current implementation, though it is already possible to automatically adopt the identifiers and labels for supported languages, you still need to use the identifiers `Q`, `A` and `N` when setting them.
- \item Currently, for typesetting questions and answers, the text is in fact being put into some sort of `description` list. As a result, the level of lists might be slightly messed up, which could sometimes lead to issues with the list labels.
+ \item Currently, for typesetting questions and answers, the text is in fact being put into some sort of `description` list (upon reflection, why did I do this? I could have simply put the label into margin...). As a result, the level of lists might be slightly messed up, which could sometimes lead to issues with the list labels.
\end{itemize}