separated_list doc and test update (#1784)

* separated_list doc update

* separated_list1_test: add empty_both

src/multi/mod.rs

@@ -335,7 +335,7 @@ where
 /// [`cut`][crate::combinator::cut].
 ///
 /// # Arguments
-/// * `sep` Parses the separator between list elements. Must be consuming.
+/// * `sep` Parses the separator between list elements.
 /// * `f` Parses the elements of the list.
 ///
 /// ```rust
@@ -457,7 +457,7 @@ where
 /// [`cut`][crate::combinator::cut].
 ///
 /// # Arguments
-/// * `sep` Parses the separator between list elements. Must be consuming.
+/// * `sep` Parses the separator between list elements.
 /// * `f` Parses the elements of the list.
 /// ```rust
 /// # use nom::{Err, error::{Error, ErrorKind}, Needed, IResult, Parser};

src/multi/tests.rs

@@ -82,6 +82,9 @@ fn separated_list1_test() {
   fn multi_longsep(i: &[u8]) -> IResult<&[u8], Vec<&[u8]>> {
     separated_list1(tag(".."), tag("abcd")).parse(i)
   }
+  fn empty_both(i: &[u8]) -> IResult<&[u8], Vec<&[u8]>> {
+    separated_list0(tag(""), tag("")).parse(i)
+  }
 
   let a = &b"abcdef"[..];
   let b = &b"abcd,abcdef"[..];
@@ -100,6 +103,10 @@ fn separated_list1_test() {
     multi(c),
     Err(Err::Error(error_position!(c, ErrorKind::Tag)))
   );
+  assert_eq!(
+    empty_both(f),
+    Err(Err::Error(error_position!(f, ErrorKind::SeparatedList)))
+  );
   let res3 = vec![&b"abcd"[..], &b"abcd"[..]];
   assert_eq!(multi(d), Ok((&b",ef"[..], res3)));