UsingScreen -> screen.mdwn
authorGreg Price <price@mit.edu>
Mon, 21 Sep 2009 00:43:47 +0000 (20:43 -0400)
committerGreg Price <price@mit.edu>
Mon, 21 Sep 2009 00:43:47 +0000 (20:43 -0400)
doc/UsingScreen [deleted file]
doc/screen.mdwn [new file with mode: 0644]

diff --git a/doc/UsingScreen b/doc/UsingScreen
deleted file mode 100644 (file)
index eb0f875..0000000
+++ /dev/null
@@ -1,45 +0,0 @@
-= Using Screen =
-
-== Why? ==
-
-{{{screen}}} is a handy tool.  It lets you get more out of a terminal session, whether in a window, via ssh, or by some more esoteric means.
-It's original reason for existence was allowing you to switch between subsessions on a [http://en.wikipedia.org/wiki/Video_terminal video-display terminal],
-but grew to allow sessions that could be detached and reattached (if you went home for the day, or say you were connecting via a glitchy network) and eventually
-to allow the same session to be simultaneously accessed from multiple places.
-
-== Getting Started ==
-
- 1.  Pick a machine to run your screen session on.  If you don't know of any options, linux.mit.edu (Linerva) is a good choice.
- 2.  ssh to that machine.
- 3.  run {{{screen}}}
- 4.  Do stuff.
-
-To detach, type "C-a d".  To reattach, type {{{screen -dr}}}
-
-If you close your ssh connection without detaching, or lose your network connection.
-
- 1.  run {{{screen -dr}}}
- 2.  Do stuff.
-
-The {{{-dr}}} means "find my screen session, detach it from wherever it's attached if it's attached, and reattach it here."
-
-Once you're comfortable with this, hit "C-a C-c".  This creates what screen calls a new "window"; it should give you a new shell prompt,
-and you can do stuff at it.  If you want to switch back to the old "window", hit "C-a C-a".   You can create as many "windows" as you want;  you can
-switch to the first 10 of them with "C-a 0" through "C-a 9" and see a list of what's open with "C-a w".  ("C-a C-a" actually means "switch to the previously
-used window".)
-
-A useful shorthand: {{{screen -dR}}} is like {{{screen -dr}}} except it adds a "if I don't already have a session, create one" step.
-
-You can use {{{screen -x}}} to attach a screen session that's already attached somewhere without detaching it first.  This can
-have side effects if the other place is already attached or is in a window that is a different size than your current one.
-It's useful when you want to share context between different screens, or even different people, but doing it when you're not
-sure where else your screen might be attached has privacy implications.
-
-== For More Information ==
-
-{{{screen}}} can do lots of stuff.   If you have a while to burn, run {{{man screen}}} at the shell prompt.   It may be helpful to do this inside of screen
-so you can put it down and come back to it later.
-
-=== TODO ===
-
-clean up, explain the "C-a C-a" notation.
\ No newline at end of file
diff --git a/doc/screen.mdwn b/doc/screen.mdwn
new file mode 100644 (file)
index 0000000..07a28d5
--- /dev/null
@@ -0,0 +1,60 @@
+[[!meta title="Using Screen"]]
+
+## Why?
+
+`screen` is a handy tool.  It lets you get more out of a terminal
+session, whether in a window, via ssh, or by some more esoteric means.
+Its original reason for existence was allowing you to switch between
+subsessions on a [video-display
+terminal](http://en.wikipedia.org/wiki/Video_terminal), but it grew to
+allow sessions that could be detached and reattached (if you went home
+for the day, or say you were connecting via a glitchy network) and
+eventually to allow the same session to be simultaneously accessed
+from multiple places.
+
+## Getting Started
+
+ 1.  Pick a machine to run your screen session on.  If you don't know of any options, linux.mit.edu (Linerva) is a good choice.
+ 2.  ssh to that machine.
+ 3.  run `screen`
+ 4.  Do stuff.
+
+To detach, type "C-a d".  To reattach, type `screen -dr`.
+
+If you close your ssh connection without detaching, or lose your
+network connection:
+
+ 1.  run `screen -dr`
+ 2.  Do stuff.
+
+The `-dr` means "find my screen session, detach it from wherever it's
+attached if it's attached, and reattach it here."
+
+Once you're comfortable with this, hit "C-a C-c".  This creates what
+screen calls a new "window"; it should give you a new shell prompt,
+and you can do stuff at it.  If you want to switch back to the old
+"window", hit "C-a C-a".  You can create as many "windows" as you
+want; you can switch to the first 10 of them with "C-a 0" through "C-a
+9" and see a list of what's open with "C-a w".  ("C-a C-a" actually
+means "switch to the previously used window".)
+
+A useful shorthand: `screen -dR` is like `screen -dr` except
+it adds a "if I don't already have a session, create one" step.
+
+You can use `screen -x` to attach a screen session that's already
+attached somewhere without detaching it first.  This can have side
+effects if the other place is already attached or is in a window that
+is a different size than your current one.  It's useful when you want
+to share context between different screens, or even different people,
+but doing it when you're not sure where else your screen might be
+attached has privacy implications.
+
+## For More Information
+
+`screen` can do lots of stuff.  If you have a while to burn, run
+`man screen` at the shell prompt.  It may be helpful to do this
+inside of `screen` so you can put it down and come back to it later.
+
+## TODO
+
+clean up, explain the "C-a C-a" notation.
\ No newline at end of file