From 953adf49d1055e0ce4e3e0af8175f18fe3897705 Mon Sep 17 00:00:00 2001
From: Xavier Robin <xavier.robin@unibas.ch>
Date: Wed, 6 Sep 2023 17:16:44 +0200
Subject: [PATCH] doc: add some specifics about the SDF format.

---
 modules/io/doc/structure_formats.rst | 14 +++++++++++++-
 1 file changed, 13 insertions(+), 1 deletion(-)

diff --git a/modules/io/doc/structure_formats.rst b/modules/io/doc/structure_formats.rst
index 42aca8826..1ed16923c 100644
--- a/modules/io/doc/structure_formats.rst
+++ b/modules/io/doc/structure_formats.rst
@@ -51,7 +51,19 @@ radii.
   
 SDF - Structured Data File
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-Chemical-data file format.
+Chemical table (Ctab) file format (V2000; read-only V3000 experimental support),
+aka MDL Molfile.
+The SDF format does not support residues, chains or atom names natively.
+The SDF importer supports loading gzipped files, which are auto-detected by the
+.gz file extension.
+
+The reader assigns 1-based atom indices as atom names.
+SDF files containing several molecules are loaded into distinct chains,
+named after the molecule name in the MOLfile header with a numerical prefix.
+Residues are named after the name in the MOLfile header as well.
+
+Chains are written as separate molecules. If a chain contains more than one
+residue, they will be merged into a single molecule.
 
 *Recognized File Extensions*
   .sdf, .sdf.gz
-- 
GitLab