-@lilypond[verbatim,quote,relative=1]
-\partial 4
-\repeat volta 2 { e4 | c2 e | }
-\alternative {
- {
- f2 d |
- \set Timing.measureLength = #(ly:make-moment 3 4)
- g4 g g % optional bar check is allowed here
+@funindex \inStaffSegno
+@cindex repeats, with segno
+@cindex segno, with repeats
+
+The @code{\inStaffSegno} command can be used to generate a composite
+bar line incorporating the segno symbol with the appropriate repeat
+bar line when used with the @code{\repeat volta} command. The
+correct type of repeat bar line, viz. start repeat, end repeat or
+double repeat, is selected automatically. Note that the
+corresponding @qq{D.S.} mark must be added manually.
+
+Away from a repeat:
+
+@lilypond[verbatim,quote]
+\relative {
+ e'1
+ \inStaffSegno
+ f2 g a b
+ c1_"D.S." \bar "|."
+}
+@end lilypond
+
+At the start of a repeat:
+
+@lilypond[verbatim,quote]
+\relative {
+ e'1
+ \repeat volta 2 {
+ \inStaffSegno % start repeat
+ f2 g a b