refactor: fix links and path for some pages

Author: std-microblock

src/components/index.ts

@@ -0,0 +1,18 @@
+import Behavior from "@components/Behavior.astro";
+import { Decl, DeclDoc } from "@components/decl-doc";
+import { DescList, Desc } from "@components/desc-list";
+import { ParamDocList, ParamDoc } from "@components/param-doc";
+import DocLink from "@components/DocLink.astro";
+import { CHeader, CppHeader } from "@components/header";
+import { FeatureTestMacro, FeatureTestMacroValue } from "@components/feature-test-macro";
+import { DR, DRList } from "@components/defect-report";
+import { Revision, RevisionBlock } from "@components/revision";
+import AutoCollapse from "@components/AutoCollapse.astro";
+import FlexTable from "@components/FlexTable.astro";
+import WG21PaperLink from "@components/WG21PaperLink.astro";
+
+export {
+    Behavior, Decl, DeclDoc, DescList, Desc, ParamDocList, ParamDoc, DocLink,
+    CHeader, CppHeader, FeatureTestMacro, FeatureTestMacroValue, DR, DRList,
+    Revision, RevisionBlock, AutoCollapse, FlexTable, WG21PaperLink
+};

…content/docs/c/library/headers/index.mdx src/content/docs/c/header/index.mdxsrc/content/docs/c/library/headers/index.mdx renamed to src/content/docs/c/header/index.mdx src/content/docs/c/library/headers/index.mdx renamed to src/content/docs/c/header/index.mdx

@@ -0,0 +1,29 @@
+---
+title: Overview
+sidebar:
+  order: 1
+cppdoc:
+  keys: ["c.lang.basic"]
+---
+
+import DocLink from "@components/DocLink.astro";
+
+# Basic concepts
+
+This section provides definitions for the specific terminology and the concepts used when describing the C programming language.
+
+A C program is a sequence of text files (typically header and source files) that coimport DocLink from "@components/DocLink.astro";
+
+# Basic concepts
+
+This section provides definitions for the specific terminology and the concepts used when describing the C programming language.
+
+A C program is a sequence of text files (typically header and source files) that contain <DocLink src="/c/language/declarations">declarations</DocLink>. They undergo <DocLink src="/c/language/translation_phases">translation</DocLink> to become an executable program, which is executed when the OS calls its <DocLink src="/c/language/main_function">main function</DocLink> (unless it is itself the OS or another *freestanding* program, in which case the entry point is implementation-defined).
+
+Certain words in a C program have special meaning, they are <DocLink src="/c/keyword">keywords</DocLink>. Others can be used as <DocLink src="/c/language/identifier">identifiers</DocLink>, which may be used to identify <DocLink src="/c/language/object">objects</DocLink>, <DocLink src="/c/language/functions">functions</DocLink>, <DocLink src="/c/language/struct">struct</DocLink>, <DocLink src="/c/language/union">union</DocLink>, or <DocLink src="/c/language/enum">enumeration</DocLink> tags, their members, <DocLink src="/c/language/typedef">typedef</DocLink> names, <DocLink src="/c/language/statements">labels</DocLink>, or  <DocLink src="/c/preprocessor/replace">macros</DocLink>.
+
+Each identifier (other than macro) is only valid within a part of the program called its <DocLink src="/c/language/scope">scope</DocLink> and belongs to one of four kinds of <DocLink src="/c/language/name_space">name spaces</DocLink>. Some identifiers have <DocLink src="/c/language/storage_duration">linkage</DocLink> which makes them refer to the same entities when they appear in different scopes or translation units.
+
+Definitions of functions include sequences of <DocLink src="/c/language/statements">statements</DocLink> and <DocLink src="/c/language/declarations">declarations</DocLink>, some of which include <DocLink src="/c/language/expressions">expressions</DocLink>, which specify the computations to be performed by the program.
+
+<DocLink src="/c/language/declarations">Declarations</DocLink> and <DocLink src="/c/language/expressions">expressions</DocLink> create, destroy, access, and manipulate <DocLink src="/c/language/object">objects</DocLink>. Each <DocLink src="/c/language/object">object</DocLink>, <DocLink src="/c/language/functions">function</DocLink>, and <DocLink src="/c/language/expressions">expression</DocLink> in C is associated with a <DocLink src="/c/language/type">type</DocLink>.

src/content/docs/c/language/basic/_meta.yml

@@ -6,24 +6,29 @@ cppdoc:
   keys: ["cpp.lang.basic"]
 ---
 
-import Missing from "@components/Missing.astro";
-import DocLink from "@components/DocLink.astro";
 import { Revision } from "@components/revision";
+import DocLink from "@components/DocLink.astro";
+
+# Basic concepts
 
 This section provides definitions for the specific terminology and the concepts used when describing the C++ programming language.
 
-A C++ program is a sequence of text files (typically header and source files) that contain <Missing>declarations</Missing>. They undergo <Missing>translation</Missing> to become an executable program, which is executed when the C++ implementation calls its <DocLink src="/cpp/language/main_function">main function</DocLink>.
+A C++ program is a sequence of text files (typically header and source files) that contain <DocLink src="/cpp/language/declarations">declarations</DocLink>. They undergo <DocLink src="/cpp/language/translation_phases">translation</DocLink> to become an executable program, which is executed when the C++ implementation calls its <DocLink src="/cpp/language/main_function">main function</DocLink>.
+
+Certain words in a C++ program have special meaning, and these are known as <DocLink src="/cpp/keyword">keywords</DocLink>. Others can be used as <DocLink src="/cpp/language/identifiers">identifiers</DocLink>. <DocLink src="/cpp/comment">Comments</DocLink> are ignored during translation. C++ programs also contain <DocLink src="/cpp/language/expressions">literals</DocLink>, the values of characters inside them are determined by <DocLink src="/cpp/language/charset">character sets and encodings</DocLink>. Certain characters in the program have to be represented with <DocLink src="/cpp/language/escape">escape sequences</DocLink>.
+
+The *entities* of a C++ program are values, <DocLink src="/cpp/language/objects">objects</DocLink>, <DocLink src="/cpp/language/reference">references</DocLink><Revision since="C++17">, <DocLink src="/cpp/language/structured_binding">structured bindings</DocLink></Revision><Revision since="C++26">, <DocLink src="/cpp/language/function">result bindings</DocLink></Revision>, <DocLink src="/cpp/language/functions">functions</DocLink>, <DocLink src="/cpp/language/enum">enumerators</DocLink>, <DocLink src="/cpp/language/type">types</DocLink>, class members, <DocLink src="/cpp/language/templates">templates</DocLink>, <DocLink src="/cpp/language/template_specialization">template specializations</DocLink><Revision since="C++11">, <DocLink src="/cpp/language/pack">packs</DocLink></Revision>, and <DocLink src="/cpp/language/namespace">namespaces</DocLink>. Preprocessor <DocLink src="/cpp/preprocessor/replace">macros</DocLink> are not C++ entities.
 
-Certain words in a C++ program have special meaning, and these are known as <Missing>keywords</Missing>. Others can be used as <Missing>identifiers</Missing>. <Missing>Comments</Missing> are ignored during translation. C++ programs also contain <Missing>literals</Missing>, the values of characters inside them are determined by <Missing>character sets and encodings</Missing>. Certain characters in the program have to be represented with <Missing>escape sequences</Missing>.
+<DocLink src="/cpp/language/declarations">Declarations</DocLink> may introduce entities, associate them with <DocLink src="/cpp/language/name">names</DocLink> and define their properties. The declarations that define all properties required to use an entity are <DocLink src="/cpp/language/definition">definitions</DocLink>. A program must contain only one definition of any non-inline function or variable that is <DocLink src="/cpp/language/definition">odr-used</DocLink>.
 
-The _entities_ of a C++ program are values, <Missing>objects</Missing>, <Missing>references</Missing><Revision since="C++17">, <Missing>structured bindings</Missing></Revision><Revision since="C++26">, <Missing>result bindings</Missing></Revision>, <Missing>functions</Missing>, <Missing>enumerators</Missing>, <Missing>types</Missing>, class members, <Missing>templates</Missing>, <Missing>template specializations</Missing><Revision since="C++11">, <Missing>packs</Missing></Revision>, and <Missing>namespaces</Missing>. Preprocessor <Missing>macros</Missing> are not C++ entities.
+Definitions of functions usually include sequences of <DocLink src="/cpp/language/statements">statements</DocLink>, some of which include <DocLink src="/cpp/language/expressions">expressions</DocLink>, which specify the computations to be performed by the program.
 
-<Missing>Declarations</Missing> may introduce entities, associate them with <Missing>names</Missing> and define their properties. The declarations that define all properties required to use an entity are <Missing>definitions</Missing>. A program must contain only one definition of any non-inline function or variable that is <Missing>odr-used</Missing>.
+Names encountered in a program are associated with the declarations that introduced them using <DocLink src="/cpp/language/lookup">name lookup</DocLink>. Each name is only valid within a part of the program called its <DocLink src="/cpp/language/scope">scope</DocLink>. Some names have <DocLink src="/cpp/language/storage_duration">linkage</DocLink> which makes them refer to the same entities when they appear in different scopes or translation units.
 
-Definitions of functions usually include sequences of <Missing>statements</Missing>, some of which include <Missing>expressions</Missing>, which specify the computations to be performed by the program.
+Each object, reference, function, expression in C++ is associated with a <DocLink src="/cpp/language/type">type</DocLink>, which may be <DocLink src="/cpp/language/types">fundamental</DocLink>, compound, or <DocLink src="/cpp/language/classes">user-defined</DocLink>, complete or <DocLink src="/cpp/language/incomplete_type">incomplete</DocLink>, etc.
 
-Names encountered in a program are associated with the declarations that introduced them using <Missing>name lookup</Missing>. Each name is only valid within a part of the program called its <Missing>scope</Missing>. Some names have <Missing>linkage</Missing> which makes them refer to the same entities when they appear in different scopes or translation units.
+Declared objects and declared references that are not <DocLink src="/cpp/language/data_members">non-static data members</DocLink> are *variables ​*.
 
-Each object, reference, function, expression in C++ is associated with a <Missing>type</Missing>, which may be <Missing>fundamental</Missing>, compound, or <Missing>user-defined</Missing>, complete or <Missing>incomplete</Missing>, etc.
+## See also
 
-Declared objects and declared references that are not <Missing>non-static data members</Missing> are _variables_. 
+C documentation for <DocLink src="/c/language/basic_concepts">Basic concepts</DocLink>