Garmelon/el
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Improve documentation of html, svg, mathml modules

Browse source
This commit is contained in:
Joscha 2024-12-02 18:56:41 +01:00
parent ccde0556f8
commit af3c2deb7f
3 changed files with 12 additions and 9 deletions
Download patch file Download diff file Expand all files Collapse all files

7
src/html.rs
View file

@ -1,6 +1,5 @@
//! Definitions for all non-deprecated HTML elements. //! Definitions for all non-deprecated HTML elements
//! //! ([MDN](https://developer.mozilla.org/en-US/docs/Web/HTML/Element)).
//! <https://developer.mozilla.org/en-US/docs/Web/HTML/Element>
use crate::{Element, ElementComponent, ElementKind}; use crate::{Element, ElementComponent, ElementKind};
@ -9,6 +8,8 @@ macro_rules! element {
element!($name, ElementKind::Normal); element!($name, ElementKind::Normal);
}; };
( $name:ident, $kind:expr ) => { ( $name:ident, $kind:expr ) => {
#[doc = concat!("The `<", stringify!($name), ">` tag")]
#[doc = concat!("([MDN](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/", stringify!($name), ")).")]
pub fn $name(c: impl ElementComponent) -> Element { pub fn $name(c: impl ElementComponent) -> Element {
Element::new(stringify!($name), $kind).with(c) Element::new(stringify!($name), $kind).with(c)
} }

7
src/mathml.rs
View file

@ -1,6 +1,5 @@
//! Definitions for all non-deprecated MathML elements. //! Definitions for all non-deprecated MathML elements
//! //! ([MDN](https://developer.mozilla.org/en-US/docs/Web/MathML/Element)).
//! <https://developer.mozilla.org/en-US/docs/Web/MathML/Element>
use crate::{Element, ElementComponent, ElementKind}; use crate::{Element, ElementComponent, ElementKind};
@ -9,6 +8,8 @@ macro_rules! element {
element!($name, stringify!($name)); element!($name, stringify!($name));
}; };
( $name:ident, $tag:expr ) => { ( $name:ident, $tag:expr ) => {
#[doc = concat!("The `<", $tag, ">` tag")]
#[doc = concat!("([MDN](https://developer.mozilla.org/en-US/docs/Web/MathML/Element/", $tag, ")).")]
pub fn $name(c: impl ElementComponent) -> Element { pub fn $name(c: impl ElementComponent) -> Element {
Element::new($tag, ElementKind::Foreign).with(c) Element::new($tag, ElementKind::Foreign).with(c)
} }

7
src/svg.rs
View file

@ -1,6 +1,5 @@
//! Definitions for all non-deprecated SVG elements. //! Definitions for all non-deprecated SVG elements
//! //! ([MDN](https://developer.mozilla.org/en-US/docs/Web/SVG/Element)).
//! <https://developer.mozilla.org/en-US/docs/Web/SVG/Element>
use crate::{Element, ElementComponent, ElementKind}; use crate::{Element, ElementComponent, ElementKind};
@ -9,6 +8,8 @@ macro_rules! element {
element!($name, stringify!($name)); element!($name, stringify!($name));
}; };
( $name:ident, $tag:expr ) => { ( $name:ident, $tag:expr ) => {
#[doc = concat!("The `<", $tag, ">` tag")]
#[doc = concat!("([MDN](https://developer.mozilla.org/en-US/docs/Web/SVG/Element/", $tag, ")).")]
pub fn $name(c: impl ElementComponent) -> Element { pub fn $name(c: impl ElementComponent) -> Element {
Element::new($tag, ElementKind::Foreign).with(c) Element::new($tag, ElementKind::Foreign).with(c)
} }