*
   * <p>This method returns the elements in the order they are returned by the collection's
   * iterator.
   *
   * <p>TODO(kevinb): support concurrently modified collections?
   *
   * @param c the collection for which to return an array of elements
   * @param array the array in which to place the collection elements

                assertEquals(testByte, buffer[i], "Byte at position " + i + " was modified");
            }

            // Check bytes after encoded area
            for (int i = startIndex + EXPECTED_SIZE; i < buffer.length; i++) {
                assertEquals(testByte, buffer[i], "Byte at position " + i + " was modified");
            }
        }

        @Test

Mais alors, nous avons à nouveau le problème d'avoir une micro-syntaxe, dans une docstring Python (un gros morceau de YAML).

L'éditeur ne peut guère aider en la matière. Et si nous modifions les paramètres ou les schémas Marshmallow et que nous oublions de modifier également cette docstring YAML, le schéma généré deviendrait obsolète.

/// info

APISpec a été créé par les développeurs de Marshmallow.

///

  E[] createArray(int length);

  /**
   * Returns the iteration ordering of elements, given the order in which they were added to the
   * container. This method may return the original list unchanged, the original list modified in
   * place, or a different list.
   *
   * <p>If the order is non-deterministic, as with {@link java.util.HashSet}, this method can return
   * its input unmodified. Provided that the test suite is built without {@link

         *
         * @param builder the XContentBuilder to use for building content
         * @param params the parameters to use during content building
         * @return the modified XContentBuilder
         * @throws IOException if an IO error occurs during building
         */
        XContentBuilder apply(XContentBuilder builder, ToXContent.Params params) throws IOException;
    }

 * This class provides functionality to map MIME types to file types and
 * retrieve appropriate file type classifications for documents during indexing.
 *
 * The mappings are loaded from configuration and can be dynamically modified
 * at runtime. When a MIME type is not found in the mapping, a default value
 * is returned.
 */
public class FileTypeHelper {
    /** Logger instance for this class */

            FileNotifyInformation modifiedImpl = createImplementation(FileNotifyInformation.FILE_ACTION_MODIFIED, "modified.txt");

            // Verify each implementation
            assertEquals(FileNotifyInformation.FILE_ACTION_ADDED, addedImpl.getAction());
            assertEquals("added.txt", addedImpl.getFileName());

                assertEquals(testByte, buffer[i], "Byte at position " + i + " was modified");
            }

            // Check bytes after encoded area
            for (int i = startIndex + expectedSize; i < buffer.length; i++) {
                assertEquals(testByte, buffer[i], "Byte at position " + i + " was modified");
            }
        }

        @Test

 */

package jcifs.smb1.util;

import java.security.MessageDigest;

/**
 * This is an implementation of the HMACT64 keyed hashing algorithm.
 * HMACT64 is defined by Luke Leighton as a modified HMAC-MD5 (RFC 2104)
 * in which the key is truncated at 64 bytes (rather than being hashed
 * via MD5).
 */
public class HMACT64 extends MessageDigest implements Cloneable {

 */

package jcifs.util;

import java.security.MessageDigest;

/**
 * This is an implementation of the HMACT64 keyed hashing algorithm.
 * HMACT64 is defined by Luke Leighton as a modified HMAC-MD5 (RFC 2104)
 * in which the key is truncated at 64 bytes (rather than being hashed
 * via MD5).
 */
class HMACT64 extends MessageDigest implements Cloneable {

    private static final int BLOCK_LENGTH = 64;