From e0c6872cf40896c7be36b11dcc744620f10adf1d Mon Sep 17 00:00:00 2001
From: Norbert Preining <norbert@preining.info>
Date: Mon, 2 Sep 2019 13:46:59 +0900
Subject: Initial commit

---
 macros/latex/contrib/clipboard/clipboard.tex | 113 +++++++++++++++++++++++++++
 1 file changed, 113 insertions(+)
 create mode 100644 macros/latex/contrib/clipboard/clipboard.tex

(limited to 'macros/latex/contrib/clipboard/clipboard.tex')

diff --git a/macros/latex/contrib/clipboard/clipboard.tex b/macros/latex/contrib/clipboard/clipboard.tex
new file mode 100644
index 0000000000..c758527baf
--- /dev/null
+++ b/macros/latex/contrib/clipboard/clipboard.tex
@@ -0,0 +1,113 @@
+% Copyright (C) 2013 Eduardo C. Lourenço de Lima
+%
+% This work may be distributed and/or modified under the
+% conditions of the LaTeX Project Public License, either
+% version 1.3 of this license or (at your option) any later
+% version.  The latest version of this license is in
+%
+%   http://www.latex-project.org/lppl.txt
+%
+% and version 1.3 or later is part of all distributions of LaTeX
+% version 2005/12/01 or later.
+%
+\documentclass{ltxdoc}
+
+\newcommand\fileversion  {0.3}
+\newcommand\filedate     {May 18, 2016}
+
+\newenvironment{Description}
+ {\par\medskip\noindent\ignorespaces}{}
+
+\newenvironment{synopsis}
+ {\begin{list}{}{\setlength\parsep{0pt}\setlength\itemsep{0pt}}}
+ {\end{list}}
+
+\title  {The \textsf{clipboard} package\thanks{This document corresponds to \textsf{clipboard}~\fileversion, dated~\filedate.}}
+\author {Eduardo C. Louren\c{c}o de Lima\\\texttt{elourenco@phi.pro.br}}
+\date   {\filedate}
+
+                                \begin{document}
+                                   \maketitle
+
+                            \section*{Introduction}
+
+The |clipboard| package provides a basic framework for copying and pasting content within a single document or across multiple documents.
+
+\begin{synopsis}
+\item |\newclipboard | \marg{basename}
+\item |\openclipboard| \marg{basename}\medskip
+\item |\Copy |         \marg{key} \marg{content}
+\item |\Paste|         \marg{key}
+\end{synopsis}
+
+                                \section{Usage}
+
+\begin{Description}
+\DescribeMacro{\newclipboard}
+The first step is to create a clipboard.
+\begin{synopsis}
+\item |\newclipboard| \marg{basename}
+\end{synopsis}
+\end{Description}
+
+\begin{Description}
+\DescribeMacro{\Copy}
+The command |\Copy| copies a \meta{content} identified as \meta{key} to the clipboard.\footnote
+{Lowercase \texttt{\char92 copy} is already defined in {\TeX}.}
+\begin{synopsis}
+\item |\Copy| \marg{key} \marg{content}
+\end{synopsis}
+\end{Description}
+
+\begin{Description}
+\DescribeMacro{\Paste}
+And the command |\Paste| pastes the content identified by \meta{key} somewhere else in the same or another document.
+See below.
+\begin{synopsis}
+\item |\Paste| \marg{key}
+\end{synopsis}
+\end{Description}
+
+\begin{Description}
+\DescribeMacro{\openclipboard}
+Finally, |\openclipboard| makes the same content available across multiple documents.
+For instance, you can paste content from |doc1.tex| into |doc2.tex|.
+Make sure to use the same \meta{basename} in both documents.
+\begin{synopsis}
+\item |\openclipboard| \marg{basename}
+\end{synopsis}
+\end{Description}
+
+                               \section{Example}
+
+This is how to copy and paste text from |book.tex| into |article.tex|:\bigskip
+
+\noindent |book.tex|:
+\begin{verbatim}
+    \documentclass{book}
+    \usepackage{clipboard}
+    \newclipboard{myclipboard}
+    \begin{document}
+        \Copy{dolorem ipsum}{Nor again is there anyone who
+        loves or pursues or desires to obtain pain of itself},
+        because it is pain, but occasionally circumstances occur
+        in which toil and pain can procure him some great pleasure.
+    \end{document}
+\end{verbatim}
+
+\noindent |article.tex|:
+\begin{verbatim}
+    \documentclass{article}
+    \usepackage{clipboard}
+    \openclipboard{myclipboard}
+    \begin{document}
+    According to Cicero,
+        \begin{quote}
+        \Paste{dolorem ipsum}
+        \end{quote}
+    \end{document}
+\end{verbatim}
+
+\noindent\textbf{Note:} Because content from |book.tex| is being copied and pasted into |article.tex|, you must run |latex book.tex| before running |latex article.tex|.
+
+                                 \end{document}
-- 
cgit v1.2.3

