* doc/as.texinfo (Previous): Clarify explanation of the behaviour of this

  pseudo-op and add a couple of examples.

2 files changed, 40 insertions, 2 deletions

diff --git a/gas/ChangeLog b/gas/ChangeLog
index 9e13cd4..c9af1a3 100644
--- a/gas/ChangeLog
+++ b/gas/ChangeLog
@@ -1,5 +1,10 @@
 2007-10-08  Nick Clifton  <nickc@redhat.com>
 
+	* doc/as.texinfo (Previous): Clarify explanation of the behaviour
+	of this pseudo-op and add a couple of examples.
+
+2007-10-08  Nick Clifton  <nickc@redhat.com>
+
 	PR gas/5121 gas/5122 gas/5123
 	* Makefile.am (CFILES): Add cgen.c
 	(TARGET_CPU_CFILES): Add tc-iq2000.c, tc-maxq.c, tc-mt.c,
diff --git a/gas/doc/as.texinfo b/gas/doc/as.texinfo
index a59b272..4e07ef0 100644
--- a/gas/doc/as.texinfo
+++ b/gas/doc/as.texinfo
@@ -5346,9 +5346,42 @@ This is one of the ELF section stack manipulation directives.  The others are
 (@pxref{PopSection}).
 
 This directive swaps the current section (and subsection) with most recently
-referenced section (and subsection) prior to this one.  Multiple
+referenced section/subsection pair prior to this one.  Multiple
 @code{.previous} directives in a row will flip between two sections (and their
-subsections).
+subsections).  For example:
+
+@smallexample
+.section A
+ .subsection 1
+  .word 0x1234
+ .subsection 2
+  .word 0x5678
+.previous
+ .word 0x9abc
+@end smallexample
+
+Will place 0x1234 and 0x9abc into subsection 1 and 0x5678 into subsection 2 of
+section A.  Whilst:
+
+@smallexample
+.section A
+.subsection 1
+  # Now in section A subsection 1
+  .word 0x1234
+.section B
+.subsection 0
+  # Now in section B subsection 0
+  .word 0x5678
+.subsection 1
+  # Now in section B subsection 1
+  .word 0x9abc
+.previous
+  # Now in section B subsection 0
+  .word 0xdef0
+@end smallexample
+
+Will place 0x1234 into section A, 0x5678 and 0xdef0 into subsection 0 of
+section B and 0x9abc into subsection 1 of section B.
 
 In terms of the section stack, this directive swaps the current section with
 the top section on the section stack.