From 94d226542957bd0a1d0193fb24fd02ae252759bb Mon Sep 17 00:00:00 2001
From: Philip Withnall <pwithnall@gnome.org>
Date: Thu, 23 Nov 2023 17:57:26 +0000
Subject: [PATCH] docs: Convert the migrating-posix page to Markdown

Signed-off-by: Philip Withnall <pwithnall@gnome.org>

Helps: #3037
---
 docs/reference/gio/gio.toml.in         |  1 +
 docs/reference/gio/meson.build         |  1 +
 docs/reference/gio/migrating-posix.md  | 17 ++++++++++++++++
 docs/reference/gio/migrating-posix.xml | 27 --------------------------
 4 files changed, 19 insertions(+), 27 deletions(-)
 create mode 100644 docs/reference/gio/migrating-posix.md
 delete mode 100644 docs/reference/gio/migrating-posix.xml

diff --git a/docs/reference/gio/gio.toml.in b/docs/reference/gio/gio.toml.in
index 5e4b1a607..40559fabb 100644
--- a/docs/reference/gio/gio.toml.in
+++ b/docs/reference/gio/gio.toml.in
@@ -61,6 +61,7 @@ content_files = [
   "migrating-gdbus.md",
   "migrating-gconf.md",
   "migrating-gnome-vfs.md",
+  "migrating-posix.md",
 
   "io-scheduler.md",
 ]
diff --git a/docs/reference/gio/meson.build b/docs/reference/gio/meson.build
index 0147259e8..586477f6c 100644
--- a/docs/reference/gio/meson.build
+++ b/docs/reference/gio/meson.build
@@ -237,6 +237,7 @@ expand_content_files = [
   'migrating-gconf.md',
   'migrating-gdbus.md',
   'migrating-gnome-vfs.md',
+  'migrating-posix.md',
   'networking.md',
   'overview.md',
   'pollable-utils.md',
diff --git a/docs/reference/gio/migrating-posix.md b/docs/reference/gio/migrating-posix.md
new file mode 100644
index 000000000..14efa1e03
--- /dev/null
+++ b/docs/reference/gio/migrating-posix.md
@@ -0,0 +1,17 @@
+Title: Migrating from POSIX to GIO
+SPDX-License-Identifier: LGPL-2.1-or-later
+SPDX-FileCopyrightText: 2007 Matthias Clasen
+
+# Migrating from POSIX to GIO
+
+## Comparison of POSIX and GIO concepts
+
+| POSIX                 | GIO                                                 |
+|-----------------------|-----------------------------------------------------|
+| `char *path`          | [iface@Gio.File]                                    |
+| `struct stat *buf`    | [class@Gio.FileInfo]                                |
+| `struct statvfs *buf` | [class@Gio.FileInfo]                                |
+| `int fd`              | [class@Gio.InputStream] or [class@Gio.OutputStream] |
+| `DIR *`               | [class@Gio.FileEnumerator]                          |
+| `fstab entry`         | [struct@Gio.UnixMountPoint]                         |
+| `mtab entry`          | [struct@Gio.UnixMountEntry]                         |
diff --git a/docs/reference/gio/migrating-posix.xml b/docs/reference/gio/migrating-posix.xml
deleted file mode 100644
index e7dc9f4fe..000000000
--- a/docs/reference/gio/migrating-posix.xml
+++ /dev/null
@@ -1,27 +0,0 @@
-<part id="migrating">
-  <title>Migrating to GIO</title>
-
-  <chapter>
-    <title>Migrating from POSIX to GIO</title>
-  
-    <table id="posix-vs-gio">
-      <title>Comparison of POSIX and GIO concepts</title>
-      <tgroup cols="2">
-        <thead>
-          <row><entry>POSIX</entry><entry>GIO</entry></row>
-        </thead>
-        <tbody>
-          <row><entry>char *path</entry><entry>GFile *file</entry></row>
-          <row><entry>struct stat *buf</entry><entry>GFileInfo *info</entry></row>
-          <row><entry>struct statvfs *buf</entry><entry>GFileInfo *info</entry></row>
-          <row><entry morerows="1">int fd</entry><entry>GInputStream *in</entry></row>
-          <row><entry>GOutputStream *out</entry></row>
-          <row><entry>DIR *</entry><entry>GFileEnumerator *enum</entry></row>
-          <row><entry>fstab entry</entry><entry>GUnixMountPoint *mount_point</entry></row>
-          <row><entry>mtab entry</entry><entry>GUnixMountEntry *mount_entry</entry></row>
-        </tbody>
-      </tgroup>
-    </table>  
-
-  </chapter>
-</part>