1
0
mirror of https://github.com/RPCS3/llvm-mirror.git synced 2024-11-23 03:02:36 +01:00

Fix -Wdocumentation warnings introduced by r342555. NFC

These were reported by buildbot llvm-clang-lld-x86_64-scei-ps4-ubuntu-fast (see
build #36798).

llvm-svn: 342640
This commit is contained in:
Andrea Di Biagio 2018-09-20 11:07:57 +00:00
parent bdca5e26c8
commit 0df44de1ff
2 changed files with 23 additions and 24 deletions

View File

@ -145,27 +145,26 @@ public:
return 0;
}
/// Returns true if \param MI is a dependency breaking zero-idiom instruction
/// for the subtarget.
/// Returns true if MI is a dependency breaking zero-idiom instruction for the
/// subtarget.
///
/// This function also sets bits in \param Mask related to input operands that
/// This function also sets bits in Mask related to input operands that
/// are not in a data dependency relationship. There is one bit for each
/// machine operand; implicit operands follow explicit operands in the bit
/// representation used for \param Mask. An empty \param Mask (i.e. a mask
/// with all bits cleared) means: data dependencies are "broken" for all the
/// explicit input machine operands of \param MI.
/// representation used for Mask. An empty (i.e. a mask with all bits
/// cleared) means: data dependencies are "broken" for all the explicit input
/// machine operands of MI.
virtual bool isZeroIdiom(const MachineInstr *MI, APInt &Mask) const {
return false;
}
/// Returns true if \param MI is a dependency breaking instruction for the
/// subtarget.
/// Returns true if MI is a dependency breaking instruction for the subtarget.
///
/// Similar in behavior to `isZeroIdiom`. However, it knows how to identify
/// all dependency breaking instructions (i.e. not just zero-idioms).
///
/// As for `isZeroIdiom`, this method returns a mask of "broken" dependencies.
/// (See method `isZeroIdiom` for a detailed description of \param Mask).
/// (See method `isZeroIdiom` for a detailed description of Mask).
virtual bool isDependencyBreaking(const MachineInstr *MI, APInt &Mask) const {
return isZeroIdiom(MI, Mask);
}

View File

@ -88,22 +88,22 @@ public:
const MCInst &Inst,
APInt &Writes) const;
/// Returns true if \param MI is a dependency breaking zero-idiom for the
/// given subtarget.
/// Returns true if MI is a dependency breaking zero-idiom for the given
/// subtarget.
///
/// \param Mask is used to identify input operands that have their dependency
/// Mask is used to identify input operands that have their dependency
/// broken. Each bit of the mask is associated with a specific input operand.
/// Bits associated with explicit input operands are laid out first in the
/// mask; implicit operands come after explicit operands.
///
/// Dependencies are broken only for operands that have their corresponding bit
/// set. Operands that have their bit cleared, or that don't have a
/// corresponding bit in the mask don't have their dependency broken.
/// Note that \param Mask may not be big enough to describe all operands.
/// The assumption for operands that don't have a correspondent bit in the
/// mask is that those are still data dependent.
/// corresponding bit in the mask don't have their dependency broken. Note
/// that Mask may not be big enough to describe all operands. The assumption
/// for operands that don't have a correspondent bit in the mask is that those
/// are still data dependent.
///
/// The only exception to the rule is for when \param Mask has all zeroes.
/// The only exception to the rule is for when Mask has all zeroes.
/// A zero mask means: dependencies are broken for all explicit register
/// operands.
virtual bool isZeroIdiom(const MCInst &MI, APInt &Mask,
@ -111,26 +111,26 @@ public:
return false;
}
/// Returns true if \param MI is a dependency breaking instruction for the
/// subtarget associated with \param CPUID.
/// Returns true if MI is a dependency breaking instruction for the
/// subtarget associated with CPUID .
///
/// The value computed by a dependency breaking instruction is not dependent
/// on the inputs. An example of dependency breaking instruction on X86 is
/// `XOR %eax, %eax`.
///
/// If \param MI is a dependency breaking instruction for subtarget \param
/// CPUID, then \param Mask can be inspected to identify independent operands.
/// If MI is a dependency breaking instruction for subtarget CPUID, then Mask
/// can be inspected to identify independent operands.
///
/// Essentially, each bit of the mask corresponds to an input operand.
/// Explicit operands are laid out first in the mask; implicit operands follow
/// explicit operands. Bits are set for operands that are independent.
///
/// Note that the number of bits in Mask may not be equivalent to the sum of
/// explicit and implicit operands in \param MI. Operands that don't have a
/// explicit and implicit operands in MI. Operands that don't have a
/// corresponding bit in Mask are assumed "not independente".
///
/// The only exception is for when \param Mask is all zeroes. That means:
/// explicit input operands of \param MI are independent.
/// The only exception is for when Mask is all zeroes. That means: explicit
/// input operands of MI are independent.
virtual bool isDependencyBreaking(const MCInst &MI, APInt &Mask,
unsigned CPUID) const {
return isZeroIdiom(MI, Mask, CPUID);