From 8b040e0a493dbabd5e8d2f921ea4a9ac9ad3e190 Mon Sep 17 00:00:00 2001 From: Nick Clifton Date: Mon, 8 Oct 2007 15:29:40 +0000 Subject: [PATCH] * doc/as.texinfo (Previous): Clarify explanation of the behaviour of this pseudo-op and add a couple of examples. --- gas/ChangeLog | 5 +++++ gas/doc/as.texinfo | 37 +++++++++++++++++++++++++++++++++++-- 2 files changed, 40 insertions(+), 2 deletions(-) diff --git a/gas/ChangeLog b/gas/ChangeLog index 9e13cd4c48..c9af1a308c 100644 --- a/gas/ChangeLog +++ b/gas/ChangeLog @@ -1,3 +1,8 @@ +2007-10-08 Nick Clifton + + * doc/as.texinfo (Previous): Clarify explanation of the behaviour + of this pseudo-op and add a couple of examples. + 2007-10-08 Nick Clifton PR gas/5121 gas/5122 gas/5123 diff --git a/gas/doc/as.texinfo b/gas/doc/as.texinfo index a59b272f60..4e07ef0e7d 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.