diff --git a/source/blender/blenkernel/BKE_packedFile.hh b/source/blender/blenkernel/BKE_packedFile.hh index 71abd02fbe3..13aeefd01a3 100644 --- a/source/blender/blenkernel/BKE_packedFile.hh +++ b/source/blender/blenkernel/BKE_packedFile.hh @@ -65,7 +65,7 @@ void BKE_packedfile_pack_all_libraries(Main *bmain, ReportList *reports); * It returns a char *to the existing file name / new file name or NULL when * there was an error or when the user decides to cancel the operation. * - * \warning 'abs_name' may be relative still! (use a "//" prefix) + * \warning 'abs_name' may be relative still! (use a `//` prefix) * be sure to run #BLI_path_abs on it first. */ char *BKE_packedfile_unpack_to_file(ReportList *reports, diff --git a/source/blender/blenkernel/BKE_path_templates.hh b/source/blender/blenkernel/BKE_path_templates.hh index 7e9800cef40..c420f791832 100644 --- a/source/blender/blenkernel/BKE_path_templates.hh +++ b/source/blender/blenkernel/BKE_path_templates.hh @@ -103,9 +103,9 @@ namespace blender::bke::path_templates { * * A filepath variable can contain either a full or partial filepath. The * distinction between string and filepath variables exists because non-path - * strings may include phrases like "and/or" or "A:Left", which shouldn't be + * strings may include phrases like `and/or` or `A:Left`, which shouldn't be * interpreted with path semantics. When used in path templating, the contents - * of string variables are therefore sanitized (replacing "/", etc.), but the + * of string variables are therefore sanitized (replacing `/`, etc.), but the * contents of filepath variables are left as-is. */ class VariableMap { @@ -210,8 +210,8 @@ class VariableMap { /** * Add the filename (sans file extension) from the given path as a variable. * - * For example, if the full path is "/home/bob/project_joe/scene_3.blend", - * then "scene_3" is the value of the added variable. + * For example, if the full path is `/home/bob/project_joe/scene_3.blend`, + * then `scene_3` is the value of the added variable. * * If the path doesn't contain a filename, then `fallback` is used for the * variable value. @@ -229,8 +229,8 @@ class VariableMap { /** * Add the path up-to-but-not-including the filename as a variable. * - * For example, if the full path is "/home/bob/project_joe/scene_3.blend", - * then "/home/bob/project_joe/" is the value of the added variable. + * For example, if the full path is `/home/bob/project_joe/scene_3.blend`, + * then `/home/bob/project_joe/` is the value of the added variable. * * If the path lacks either a filename or a path leading up to that filename, * then `fallback` is used for the variable value. @@ -370,9 +370,9 @@ blender::Vector BKE_path_validate_template( * - `##.###`: format as a float with at least 2 integer-part digits (padded * with zeros as necessary) and precisely 3 fractional-part digits. * - * This function also processes a simple escape sequence for writing literal "{" - * and "}": like Python format strings, double braces "{{" and "}}" are treated - * as escape sequences for "{" and "}", and are substituted appropriately. Note + * This function also processes a simple escape sequence for writing literal `{` + * and `}`: like Python format strings, double braces `{{` and `}}` are treated + * as escape sequences for `{` and `}`, and are substituted appropriately. Note * that this substitution only happens *outside* of the variable syntax, and * therefore cannot e.g. be used inside variable names. * @@ -413,7 +413,7 @@ void BKE_report_path_template_errors(ReportList *reports, /** * Format the given floating point value with the provided format specifier. The format specifier - * is e.g. the "##.###" in "{name:##.###}". + * is e.g. the `##.###` in `{name:##.###}`. * * \return #std::nullopt if the format specifier is invalid. */ diff --git a/source/blender/blenkernel/intern/lib_id.cc b/source/blender/blenkernel/intern/lib_id.cc index 58709787d02..fbbcd52ea18 100644 --- a/source/blender/blenkernel/intern/lib_id.cc +++ b/source/blender/blenkernel/intern/lib_id.cc @@ -147,7 +147,7 @@ static bool lib_id_library_local_paths_callback(BPathForeachPathData *bpath_data if (BLI_path_abs(filepath, base_old)) { /* Path was relative and is now absolute. Remap. * Important BLI_path_normalize runs before the path is made relative - * because it won't work for paths that start with "//../" */ + * because it won't work for paths that start with `//../` */ BLI_path_normalize(filepath); BLI_path_rel(filepath, base_new); BLI_strncpy(path_dst, filepath, path_dst_maxncpy); diff --git a/source/blender/blenkernel/intern/path_templates.cc b/source/blender/blenkernel/intern/path_templates.cc index 5ec482acddd..68b99247b86 100644 --- a/source/blender/blenkernel/intern/path_templates.cc +++ b/source/blender/blenkernel/intern/path_templates.cc @@ -280,9 +280,9 @@ void BKE_add_template_variables_general(VariableMap &variables, const ID *path_o variables.add_filename_only( "blend_name", g_blend_file_path, blender::StringRef(DATA_("Unsaved"))); - /* Note: fallback to "./" for unsaved files, which if used at the start of a + /* Note: fallback to `./` for unsaved files, which if used at the start of a * path is equivalent to the current working directory. This is consistent - * with how "//" works. */ + * with how `//` works. */ variables.add_path_up_to_file("blend_dir", g_blend_file_path, blender::StringRef("./")); } @@ -292,9 +292,9 @@ void BKE_add_template_variables_general(VariableMap &variables, const ID *path_o variables.add_filename_only( "blend_name_lib", lib_blend_file_path, blender::StringRef(DATA_("Unsaved"))); - /* Note: fallback to "./" for unsaved files, which if used at the start of a + /* Note: fallback to `./` for unsaved files, which if used at the start of a * path is equivalent to the current working directory. This is consistent - * with how "//" works. */ + * with how `//` works. */ variables.add_path_up_to_file("blend_dir_lib", lib_blend_file_path, blender::StringRef("./")); } } diff --git a/source/blender/blenlib/BLI_path_utils.hh b/source/blender/blenlib/BLI_path_utils.hh index 76552ef0c61..8de469050f0 100644 --- a/source/blender/blenlib/BLI_path_utils.hh +++ b/source/blender/blenlib/BLI_path_utils.hh @@ -203,7 +203,7 @@ void BLI_path_normalize_unc(char *path, int path_maxncpy); * This is intended for system paths (passed in as command-line arguments of via scripts) * which are valid in that they resolve to a file/directory and but could be `CWD` relative or * contain redundant slashes that cause absolute/relative conversion to fail. - * (specifically the "//" prefix used by Blender). + * (specifically the `//` prefix used by Blender). * * Perform the following operations: * @@ -669,24 +669,24 @@ bool BLI_path_frame_check_chars(const char *path) ATTR_NONNULL(1) ATTR_WARN_UNUS #endif /** - * If path begins with "//", strips that and replaces it with `basepath` directory. + * If path begins with `//`, strips that and replaces it with `basepath` directory. * * \note Also converts drive-letter prefix to something more sensible * if this is a non-drive-letter-based system. * * \param path: The path to convert. * \param basepath: The directory to base relative paths with. - * \return true if the path was relative (started with "//"). + * \return true if the path was relative (started with `//`). */ bool BLI_path_abs(char path[FILE_MAX], const char *basepath) ATTR_NONNULL(1, 2); /** - * Replaces `path` with a relative version (prefixed by "//") such that #BLI_path_abs, given + * Replaces `path` with a relative version (prefixed by `//`) such that #BLI_path_abs, given * the same `basepath`, will convert it back to its original value. */ void BLI_path_rel(char path[FILE_MAX], const char *basepath) ATTR_NONNULL(1); /** - * Does path begin with the special "//" prefix that Blender uses to indicate + * Does path begin with the special `//` prefix that Blender uses to indicate * a path relative to the .blend file. */ bool BLI_path_is_rel(const char *path) ATTR_NONNULL(1) ATTR_WARN_UNUSED_RESULT; @@ -698,7 +698,7 @@ bool BLI_path_is_rel(const char *path) ATTR_NONNULL(1) ATTR_WARN_UNUSED_RESULT; * \{ */ /** - * Checks for a relative path (ignoring Blender's "//") prefix + * Checks for a relative path (ignoring Blender's `//`) prefix * (unlike `!BLI_path_is_rel(path)`). * When false, #BLI_path_abs_from_cwd would expand the absolute path. */ @@ -708,7 +708,7 @@ bool BLI_path_is_abs_from_cwd(const char *path) ATTR_NONNULL(1) ATTR_WARN_UNUSED * \returns true if the expansion was performed. * * \note Should only be called with command line paths. - * This is _not_ something Blender's internal paths support, instead they use the "//" prefix. + * This is _not_ something Blender's internal paths support, instead they use the `//` prefix. * In most cases #BLI_path_abs should be used instead. */ bool BLI_path_abs_from_cwd(char *path, size_t path_maxncpy) ATTR_NONNULL(1); diff --git a/source/blender/blenlib/intern/path_utils.cc b/source/blender/blenlib/intern/path_utils.cc index 38818631b67..4f0343ff766 100644 --- a/source/blender/blenlib/intern/path_utils.cc +++ b/source/blender/blenlib/intern/path_utils.cc @@ -1898,7 +1898,7 @@ bool BLI_path_contains(const char *container_path, const char *containee_path) } /* Add a trailing slash to prevent same-prefix directories from matching. - * e.g. "/some/path" doesn't contain "/some/path_lib". */ + * e.g. `/some/path` doesn't contain `/some/path_lib`. */ BLI_path_slash_ensure(container_native, sizeof(container_native)); return BLI_str_startswith(containee_native, container_native);