From ac82913b7ab0b1e7ff8f14c7fa6b3fa1111f321d Mon Sep 17 00:00:00 2001
From: kenjis <kenji.uui@gmail.com>
Date: Wed, 24 Jul 2024 10:11:48 +0900
Subject: [PATCH 1/4] docs: remove `<?php` in sample code

---
 user_guide_src/source/libraries/files.rst | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/user_guide_src/source/libraries/files.rst b/user_guide_src/source/libraries/files.rst
index 0b55982692c2..b4c69e6c0177 100644
--- a/user_guide_src/source/libraries/files.rst
+++ b/user_guide_src/source/libraries/files.rst
@@ -18,6 +18,7 @@ By default, the file does not need to exist. However, you can pass an additional
 to check that the file exists and throw ``FileNotFoundException()`` if it does not.
 
 .. literalinclude:: files/001.php
+    :lines: 2-
 
 Taking Advantage of Spl
 ***********************
@@ -25,6 +26,7 @@ Taking Advantage of Spl
 Once you have an instance, you have the full power of the SplFileInfo class at the ready, including:
 
 .. literalinclude:: files/002.php
+    :lines: 2-
 
 New Features
 ************
@@ -38,6 +40,7 @@ You can generate a cryptographically secure random filename, with the current ti
 method. This is especially useful to rename files when moving it so that the filename is unguessable:
 
 .. literalinclude:: files/003.php
+    :lines: 2-
 
 getSize()
 =========
@@ -45,6 +48,7 @@ getSize()
 Returns the size of the uploaded file in bytes:
 
 .. literalinclude:: files/004.php
+    :lines: 2-
 
 getSizeByUnit()
 ===============
@@ -53,6 +57,7 @@ Returns the size of the uploaded file default in bytes. You can pass in either '
 the results in kilobytes or megabytes, respectively:
 
 .. literalinclude:: files/005.php
+    :lines: 2-
 
 getMimeType()
 =============
@@ -61,6 +66,7 @@ Retrieve the media type (mime type) of the file. Uses methods that are considere
 the type of file:
 
 .. literalinclude:: files/006.php
+    :lines: 2-
 
 guessExtension()
 ================
@@ -70,6 +76,7 @@ will return null. This is often a more trusted source than simply using the exte
 the values in **app/Config/Mimes.php** to determine extension:
 
 .. literalinclude:: files/007.php
+    :lines: 2-
 
 Moving Files
 ============
@@ -78,12 +85,15 @@ Each file can be moved to its new location with the aptly named ``move()`` metho
 the file to as the first parameter:
 
 .. literalinclude:: files/008.php
+    :lines: 2-
 
 By default, the original filename was used. You can specify a new filename by passing it as the second parameter:
 
 .. literalinclude:: files/009.php
+    :lines: 2-
 
 The move() method returns a new File instance that for the relocated file, so you must capture the result if the
 resulting location is needed:
 
 .. literalinclude:: files/010.php
+    :lines: 2-

From e22cfa15eb1dee01f29bcfaa2fd1e7e1e53ebddb Mon Sep 17 00:00:00 2001
From: kenjis <kenji.uui@gmail.com>
Date: Wed, 24 Jul 2024 10:12:26 +0900
Subject: [PATCH 2/4] docs: remove "uploaded"

The File class is not only for uploaded files.
---
 user_guide_src/source/libraries/files.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/user_guide_src/source/libraries/files.rst b/user_guide_src/source/libraries/files.rst
index b4c69e6c0177..b0e832b78e7d 100644
--- a/user_guide_src/source/libraries/files.rst
+++ b/user_guide_src/source/libraries/files.rst
@@ -45,7 +45,7 @@ method. This is especially useful to rename files when moving it so that the fil
 getSize()
 =========
 
-Returns the size of the uploaded file in bytes:
+Returns the size of the file in bytes:
 
 .. literalinclude:: files/004.php
     :lines: 2-
@@ -53,7 +53,7 @@ Returns the size of the uploaded file in bytes:
 getSizeByUnit()
 ===============
 
-Returns the size of the uploaded file default in bytes. You can pass in either 'kb' or 'mb' as the first parameter to get
+Returns the size of the file default in bytes. You can pass in either ``'kb'`` or ``'mb'`` as the first parameter to get
 the results in kilobytes or megabytes, respectively:
 
 .. literalinclude:: files/005.php

From f44e97c166c4c0f5fc80ecf482f3fceca79040df Mon Sep 17 00:00:00 2001
From: kenjis <kenji.uui@gmail.com>
Date: Wed, 24 Jul 2024 10:13:15 +0900
Subject: [PATCH 3/4] docs: decorate method name

---
 user_guide_src/source/libraries/files.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/user_guide_src/source/libraries/files.rst b/user_guide_src/source/libraries/files.rst
index b0e832b78e7d..89bfd13ab550 100644
--- a/user_guide_src/source/libraries/files.rst
+++ b/user_guide_src/source/libraries/files.rst
@@ -92,7 +92,7 @@ By default, the original filename was used. You can specify a new filename by pa
 .. literalinclude:: files/009.php
     :lines: 2-
 
-The move() method returns a new File instance that for the relocated file, so you must capture the result if the
+The ``move()`` method returns a new File instance that for the relocated file, so you must capture the result if the
 resulting location is needed:
 
 .. literalinclude:: files/010.php

From 5340d8d59979d90f2074c0fc9be0a63233958946 Mon Sep 17 00:00:00 2001
From: kenjis <kenji.uui@gmail.com>
Date: Wed, 24 Jul 2024 10:13:56 +0900
Subject: [PATCH 4/4] docs: move sentence down

---
 user_guide_src/source/libraries/files.rst | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/user_guide_src/source/libraries/files.rst b/user_guide_src/source/libraries/files.rst
index 89bfd13ab550..8594fd8156c5 100644
--- a/user_guide_src/source/libraries/files.rst
+++ b/user_guide_src/source/libraries/files.rst
@@ -14,12 +14,13 @@ Getting a File instance
 ***********************
 
 You create a new File instance by passing in the path to the file in the constructor.
-By default, the file does not need to exist. However, you can pass an additional argument of "true"
-to check that the file exists and throw ``FileNotFoundException()`` if it does not.
 
 .. literalinclude:: files/001.php
     :lines: 2-
 
+By default, the file does not need to exist. However, you can pass an additional argument of ``true``
+to check that the file exists and throw ``FileNotFoundException()`` if it does not.
+
 Taking Advantage of Spl
 ***********************